@marvalt/digivalt-core 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - Initial Release
+
+### Added
+- Initial scaffolding of `@marvalt/digivalt-core` NPM package
+- Ported static data generation and environment configuration from `digivalt-core-v1`
+- Integrated runtime logic and service adapters (`suitecrm`, `mautic`, `wordpress`, `gravityForms`)
+- Consolidated dynamic hooks (`useCaseStudies`, `useMautic`, `useSuiteCRM`, `useWordPressData`, etc.)
+- Exported base UI organisms and molecule components configured to work with the overarching app Shadcn UI elements
+- Complete configuration for Rollup CJS and ESM module exports
+- Flexible dynamic typings allowing interoperable generic interfaces for Lovable consumers

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The ViBuNe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @marvalt/digivalt-core
+
+Core logic and shared context for DigiVAlt frontend applications.
+
+## Installation
+
+```bash
+npm install @marvalt/digivalt-core
+```
+
+## Overview
+This package contains the shared "glue" code that unifies WordPress headless configurations, Mautic connections, Cloudflare setup, and form integrations for DigiValt static-first applications. 
+It makes it easy to convert any standard React/Vite app into a full DigiVAlt implementation.

package/dist/components/WordPressFooter.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+interface WordPressFooterProps {
+    fallback?: React.ReactNode;
+    className?: string;
+    onFooterStatusChange?: (hasFooter: boolean) => void;
+}
+/**
+ * WordPressFooter - Renders footer from WordPress template part
+ *
+ * This component:
+ * - Loads WordPress static data
+ * - Fetches footer template part blocks
+ * - Renders using WPPage component from wparser
+ * - Applies custom colors using existing color extraction logic
+ */
+export declare const WordPressFooter: React.FC<WordPressFooterProps>;
+export {};

package/dist/components/index.d.ts

@@ -0,0 +1,9 @@
+export * from './integrations/chatwoot-widget';
+export * from './integrations/mautic-tracking';
+export * from './WordPressFooter';
+export * from './organisms/StaticGravityForm';
+export * from './organisms/MauticForm';
+export * from './organisms/MauticFormPopup/MauticFormPopup';
+export * from './organisms/GravityFormPopup/GravityFormPopup';
+export * from './molecules/DynamicHeroSection';
+export * from './molecules/WordPressNavMenu';

package/dist/components/integrations/chatwoot-widget.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+interface ChatwootConfig {
+    websiteToken: string;
+    baseUrl?: string;
+    locale?: string;
+    type?: 'standard' | 'expanded_bubble';
+    launcherTitle?: string;
+    hideMessageBubble?: boolean;
+    position?: 'left' | 'right';
+    showPopoutButton?: boolean;
+}
+interface ChatwootWidgetProps {
+    config: ChatwootConfig;
+    enabled?: boolean;
+    className?: string;
+}
+interface ChatwootWidgetRef {
+    toggle: () => void;
+    show: () => void;
+    hide: () => void;
+    reset: () => void;
+}
+declare global {
+    interface Window {
+        chatwootSettings: {
+            hideMessageBubble?: boolean;
+            position?: 'left' | 'right';
+            locale?: string;
+            type?: 'standard' | 'expanded_bubble';
+            launcherTitle?: string;
+            showPopoutButton?: boolean;
+        };
+        chatwootSDK: {
+            run: (config: any) => void;
+            toggle: () => void;
+            show: () => void;
+            hide: () => void;
+            reset: () => void;
+        };
+    }
+}
+export declare const ChatwootWidget: React.ForwardRefExoticComponent<ChatwootWidgetProps & React.RefAttributes<ChatwootWidgetRef>>;
+export declare const useChatwoot: () => {
+    isLoaded: boolean;
+    toggle: () => void;
+    show: () => void;
+    hide: () => void;
+    reset: () => void;
+};
+export declare const defaultChatwootConfig: ChatwootConfig;
+export {};

package/dist/components/integrations/mautic-tracking.d.ts

@@ -0,0 +1,9 @@
+interface MauticTrackingProps {
+    enabled?: boolean;
+    mauticUrl?: string;
+    proxyUrl?: string;
+    appId?: string;
+    workerSecret?: string;
+}
+declare const MauticTracking: React.FC<MauticTrackingProps>;
+export default MauticTracking;

package/dist/components/molecules/CaseStudyCard.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { WordPressCaseStudy } from '../../types/caseStudies';
+interface CaseStudyCardProps {
+    caseStudy: WordPressCaseStudy;
+    onViewCaseStudy?: (caseStudy: WordPressCaseStudy) => void;
+    /** Optional: Override className */
+    className?: string;
+}
+declare const CaseStudyCard: React.FC<CaseStudyCardProps>;
+export default CaseStudyCard;

package/dist/components/molecules/DynamicHeroSection.d.ts

@@ -0,0 +1,56 @@
+import React from 'react';
+import { type WordPressBlock, type ComponentRegistry } from '@marvalt/wparser';
+export interface DynamicHeroSectionProps {
+    /** Background image URL (will be converted to Cloudflare variant) */
+    backgroundImage?: string | null;
+    /** Main heading/title (can be string or React node for shortcode support) */
+    title?: string | React.ReactNode | null;
+    /** Subtitle/description text (can be string or React node for shortcode support) */
+    subtitle?: string | React.ReactNode | null;
+    /** Button configuration */
+    buttons?: Array<{
+        text: string;
+        url: string;
+        isExternal?: boolean;
+    }>;
+    /** Video iframe HTML (for embedding videos) */
+    videoIframe?: string | null;
+    /** Overlay opacity (0-100) */
+    overlayOpacity?: number;
+    /** Overlay color (hex, rgb, or CSS color value) */
+    overlayColor?: string | null;
+    /** Minimum height (e.g., "100vh", "840px") */
+    minHeight?: string;
+    /** Content alignment - controls WHERE the container is positioned (from contentPosition) */
+    contentAlign?: 'left' | 'center' | 'right';
+    /** Text alignment - controls how text is aligned WITHIN the container (from textAlign attributes) */
+    textAlign?: 'left' | 'center' | 'right';
+    /** Vertical alignment */
+    verticalAlign?: 'top' | 'center' | 'bottom';
+    /** WordPress block alignment: 'wide', 'full', or undefined/null (None/default) */
+    align?: 'wide' | 'full' | null;
+    /** Text color class for title (e.g., 'text-white', 'text-[#eb8900]') */
+    titleTextColor?: string | null;
+    /** Optional Gravity Form ID to render inline within the hero */
+    gravityFormId?: string | number | null;
+    /** Whether cover block has columns structure - if true, render innerBlocks using registry */
+    hasColumns?: boolean;
+    /** Inner blocks to render when hasColumns is true */
+    innerBlocks?: WordPressBlock[];
+    /** Registry for rendering blocks when hasColumns is true */
+    registry?: ComponentRegistry;
+}
+/**
+ * Dynamic Hero Section component that accepts props from WordPress blocks
+ *
+ * This component is designed to work with WordPress cover blocks, extracting
+ * content from innerBlocks and rendering with app-controlled CSS.
+ *
+ * Content managers can control:
+ * - Vertical alignment via contentPosition in WordPress (top, center, bottom)
+ * - Horizontal alignment via contentPosition or textAlign in WordPress
+ * - Background image, overlay opacity, min height
+ * - Title, subtitle, buttons, video
+ */
+declare const DynamicHeroSection: React.FC<DynamicHeroSectionProps>;
+export default DynamicHeroSection;

package/dist/components/molecules/MemberCard.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { WordPressMember } from '../../types/members';
+interface MemberCardProps {
+    member: WordPressMember;
+    onViewProfile?: (member: WordPressMember) => void;
+    /** Optional: Override className */
+    className?: string;
+    /** Optional: Override title font size */
+    titleSize?: string;
+}
+declare const MemberCard: React.FC<MemberCardProps>;
+export default MemberCard;

package/dist/components/molecules/NavMenu.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @deprecated This component is deprecated. Use WordPressNavMenu instead.
+ *
+ * This component is preserved for reference. The new WordPressNavMenu component
+ * automatically generates navigation from WordPress page hierarchy.
+ *
+ * To migrate:
+ * 1. Replace <NavMenu /> with <WordPressNavMenu />
+ * 2. Create pages in WordPress to control menu structure
+ * 3. This file can be removed after migration is complete
+ */
+import React from 'react';
+export declare const NavMenu: React.FC;

package/dist/components/molecules/ProjectCard.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { WordPressProject } from '../../types/projects';
+interface ProjectCardProps {
+    project: WordPressProject;
+    onViewProject?: (project: WordPressProject) => void;
+    /** Optional: Override className */
+    className?: string;
+}
+declare const ProjectCard: React.FC<ProjectCardProps>;
+export default ProjectCard;

package/dist/components/molecules/SearchForm.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface SearchFormProps {
+    onSearch: (query: string) => void;
+    placeholder?: string;
+}
+export declare const SearchForm: React.FC<SearchFormProps>;
+export {};

package/dist/components/molecules/TestimonialCard/TestimonialCard.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { Testimonial } from '../../../services/wordpress';
+interface TestimonialCardProps {
+    testimonial: Testimonial;
+}
+declare const TestimonialCard: React.FC<TestimonialCardProps>;
+export default TestimonialCard;

package/dist/components/molecules/WordPressNavMenu.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+interface WordPressNavMenuProps {
+    className?: string;
+    textColor?: 'light' | 'dark';
+    /** Optional: Override fontSize (uses CSS variable by default) */
+    fontSize?: string;
+    /** Optional: Override fontWeight (uses CSS variable by default) */
+    fontWeight?: string;
+    /** Optional: Specific menu ID to use (if not provided, uses header menu) */
+    menuId?: number;
+    /** Layout direction: 'horizontal' for header, 'vertical' for footer */
+    layout?: 'horizontal' | 'vertical';
+}
+/**
+ * WordPressNavMenu - Navigation menu from WordPress header template part
+ *
+ * Priority:
+ * 1. Uses navigation menu from WordPress header template part (if available)
+ * 2. Falls back to page hierarchy-based menu (all published pages)
+ *
+ * This allows content teams to control menu items via WordPress Appearance > Menus,
+ * while still supporting automatic menu generation from page hierarchy as fallback.
+ */
+export declare const WordPressNavMenu: React.FC<WordPressNavMenuProps>;
+export {};

package/dist/components/molecules/breadcrumbs.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+interface BreadcrumbItem {
+    label: string;
+    href: string;
+    current?: boolean;
+}
+interface BreadcrumbsProps {
+    items?: BreadcrumbItem[];
+    className?: string;
+    showHome?: boolean;
+    homeLabel?: string;
+    separator?: React.ReactNode;
+    maxItems?: number;
+}
+export declare const Breadcrumbs: React.FC<BreadcrumbsProps>;
+export declare const useBreadcrumbs: (customItems?: BreadcrumbItem[]) => BreadcrumbItem[];
+export {};

package/dist/components/molecules/hero-section.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+interface HeroSectionProps {
+    title: string;
+    subtitle?: string;
+    description?: string;
+    primaryAction?: {
+        label: string;
+        href: string;
+        variant?: 'default' | 'outline' | 'secondary';
+    };
+    secondaryAction?: {
+        label: string;
+        href: string;
+        variant?: 'default' | 'outline' | 'secondary';
+    };
+    image?: {
+        src: string;
+        alt: string;
+    };
+    video?: {
+        src: string;
+        poster?: string;
+    };
+    layout?: 'left' | 'right' | 'center' | 'split';
+    theme?: 'light' | 'dark' | 'gradient';
+    backgroundImage?: string;
+    stats?: Array<{
+        value: string;
+        label: string;
+    }>;
+    badges?: Array<{
+        text: string;
+        icon?: React.ReactNode;
+    }>;
+    className?: string;
+}
+export declare const HeroSection: React.FC<HeroSectionProps>;
+export declare const HomeHero: React.FC<Omit<HeroSectionProps, 'layout' | 'theme'>>;
+export declare const ServiceHero: React.FC<Omit<HeroSectionProps, 'layout' | 'theme'>>;
+export declare const ProductHero: React.FC<Omit<HeroSectionProps, 'layout' | 'theme'>>;
+export {};

package/dist/components/organisms/GravityFormPopup/GravityFormPopup.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface GravityFormPopupProps {
+    formId: number;
+    isOpen: boolean;
+    onClose: () => void;
+}
+declare const GravityFormPopup: React.FC<GravityFormPopupProps>;
+export default GravityFormPopup;

package/dist/components/organisms/GravityFormSubmissions/GravityFormSubmissionsComponent.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { GravityFormEntry, GravityFormSubmissionResponse } from '../../../services/gravityForms';
+interface GravityFormSubmissionsComponentProps {
+    form: GravityForm;
+    onSubmit: (entry: GravityFormEntry) => Promise<GravityFormSubmissionResponse>;
+    className?: string;
+}
+export declare const GravityFormSubmissionsComponent: React.FC<GravityFormSubmissionsComponentProps>;
+export {};

package/dist/components/organisms/GravityFormSubmissions/index.d.ts

@@ -0,0 +1 @@
+export { GravityFormSubmissionsComponent } from './GravityFormSubmissionsComponent';

package/dist/components/organisms/Header.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export interface HeaderProps {
+    /** Optional slot for dev-added content (search, buttons) in the header row */
+    headerExtras?: React.ReactNode;
+}
+export declare const Header: React.FC<HeaderProps>;

package/dist/components/organisms/Hero.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const Hero: React.FC;

package/dist/components/organisms/MauticForm/MauticForm.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface MauticFormProps {
+    formId: string;
+    title?: string;
+    description?: string;
+    className?: string;
+}
+export declare const MauticForm: React.FC<MauticFormProps>;
+export {};

package/dist/components/organisms/MauticForm/ThemedMauticForm.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+export interface ThemedMauticFormProps {
+    formId: string;
+    title?: string;
+    description?: string;
+    className?: string;
+}
+export declare const ThemedMauticForm: React.FC<ThemedMauticFormProps>;
+export default ThemedMauticForm;

package/dist/components/organisms/MauticForm/index.d.ts

@@ -0,0 +1 @@
+export { ThemedMauticForm as MauticForm } from './ThemedMauticForm';

package/dist/components/organisms/MauticFormPopup/MauticFormPopup.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface MauticFormPopupProps {
+    formId: string | number;
+    isOpen: boolean;
+    onClose: () => void;
+    title?: string;
+}
+declare const MauticFormPopup: React.FC<MauticFormPopupProps>;
+export default MauticFormPopup;

package/dist/components/organisms/MemberProfileDialog.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { WordPressMember } from '../../types/members';
+interface MemberProfileDialogProps {
+    member: WordPressMember | null;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+declare const MemberProfileDialog: React.FC<MemberProfileDialogProps>;
+export default MemberProfileDialog;

package/dist/components/organisms/StaticGravityForm/StaticGravityForm.d.ts

@@ -0,0 +1,40 @@
+/**
+ * StaticGravityForm Component
+ *
+ * Renders Gravity Forms using static data (from /gravity-forms-data.json)
+ * and only uses API calls for form submission.
+ *
+ * This component separates form rendering (static) from form submission (API),
+ * ensuring forms always render from static data regardless of connection type.
+ */
+import React from 'react';
+import type { GravityFormsConfig, GravityFormSubmissionResult } from '@marvalt/wadapter';
+declare global {
+    interface Window {
+        turnstile: {
+            render: (container: string | HTMLElement, options: {
+                sitekey: string;
+                action?: string;
+                cData?: string;
+                callback?: (token: string) => void;
+                'error-callback'?: () => void;
+                'expired-callback'?: () => void;
+                theme?: 'light' | 'dark' | 'auto';
+                size?: 'normal' | 'compact';
+                tabindex?: number;
+            }) => string;
+            reset: (widgetId: string) => void;
+            remove: (widgetId: string) => void;
+            getResponse: (widgetId: string) => string | undefined;
+        };
+    }
+}
+interface StaticGravityFormProps {
+    formId: number | string;
+    config: GravityFormsConfig;
+    className?: string;
+    onSubmit?: (result: GravityFormSubmissionResult) => void;
+    onError?: (error: Error) => void;
+}
+export declare const StaticGravityForm: React.FC<StaticGravityFormProps>;
+export default StaticGravityForm;

package/dist/components/organisms/StaticGravityForm/index.d.ts

@@ -0,0 +1,2 @@
+export { StaticGravityForm } from './StaticGravityForm';
+export { default } from './StaticGravityForm';

package/dist/components/organisms/SuiteCRMLeadForm/SuiteCRMLeadForm.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface SuiteCRMLeadFormProps {
+    className?: string;
+    title?: string;
+    description?: string;
+    leadSource?: string;
+    campaign?: string;
+    successMessage?: string;
+    onSuccess?: (data: any) => void;
+    onError?: (error: Error) => void;
+}
+export declare const SuiteCRMLeadForm: React.FC<SuiteCRMLeadFormProps>;

package/dist/components/organisms/SuiteCRMLeadForm/index.d.ts

@@ -0,0 +1,2 @@
+export { SuiteCRMLeadForm } from './SuiteCRMLeadForm';
+export type { SuiteCRMLeadFormProps } from './SuiteCRMLeadForm';

package/dist/config/app-customization.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Application Customization Configuration
+ *
+ * Fork developers should ONLY modify this file (or create customization.json)
+ * for styling customizations. All other component code should remain untouched
+ * for upstream compatibility.
+ *
+ * Priority order:
+ * 1. customization.json file (if exists) - highest priority
+ * 2. Environment variables
+ * 3. Default values in this file
+ */
+export interface ComponentCustomization {
+    className?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    fontFamily?: string;
+    textColor?: string;
+    backgroundColor?: string;
+    padding?: string;
+    gap?: string;
+    [key: string]: any;
+}
+export interface AppCustomizationConfig {
+    typography: {
+        menu: {
+            fontSize: string;
+            fontWeight: string;
+            lineHeight: string;
+            fontFamily?: string;
+        };
+        card: {
+            titleSize: string;
+            bodySize: string;
+            fontWeight?: string;
+        };
+        hero: {
+            titleSize: string;
+            subtitleSize: string;
+            titleWeight?: string;
+        };
+    };
+    colors: {
+        menu: {
+            text: string;
+            textHover: string;
+            textActive: string;
+            background: string;
+        };
+        card: {
+            background: string;
+            border: string;
+            text: string;
+            titleColor?: string;
+        };
+    };
+    spacing: {
+        menu: {
+            itemGap: string;
+            dropdownPadding: string;
+        };
+        card: {
+            padding: string;
+            gap: string;
+        };
+    };
+    components: {
+        WordPressNavMenu?: ComponentCustomization;
+        MemberCard?: ComponentCustomization;
+        CaseStudyCard?: ComponentCustomization;
+        ProjectCard?: ComponentCustomization;
+        DynamicHeroSection?: ComponentCustomization;
+        Header?: ComponentCustomization;
+        Footer?: ComponentCustomization;
+        NotFound?: ComponentCustomization;
+        [key: string]: ComponentCustomization | undefined;
+    };
+}
+export declare const defaultCustomization: AppCustomizationConfig;
+/**
+ * Get the complete customization configuration
+ * Merges defaults with custom config and environment overrides
+ *
+ * This function is safe to call and will never throw errors
+ */
+export declare function getCustomizationConfig(): AppCustomizationConfig;
+/**
+ * Get customization for a specific component
+ *
+ * This function is safe to call and will never throw errors
+ */
+export declare function getComponentCustomization(componentName: keyof AppCustomizationConfig['components']): ComponentCustomization | undefined;