@codefluss/base-types 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,60 @@
+# @codefluss/base-types
+
+Shared type definitions for the Codefluss Page Builder plugin system.
+
+## Overview
+
+This package provides the single source of truth for all plugin-related TypeScript types, ensuring
+type consistency across the entire plugin ecosystem.
+
+## Installation
+
+```bash
+pnpm add @codefluss/base-types
+```
+
+## Usage
+
+```typescript
+import type {
+  PluginConfig,
+  PropertyDefinition,
+  PluginDependencies,
+  PluginCapabilities,
+} from '@codefluss/base-types';
+
+export const myPluginConfig: PluginConfig = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  // ...
+};
+```
+
+## Exported Types
+
+### Plugin System Types (`plugin-system.ts`)
+
+- **Core Types**: `PropertyControlType`, `PropertyType`, `PropertyCategory`, `PropertyPriority`
+- **Control Configs**: `SliderConfig`, `NumberConfig`, `SelectConfig`, `InputConfig`, etc.
+- **Property Definition**: `PropertyDefinition`, `PropertyUIConfig`, `PropertyValidation`
+- **Plugin Config**: `PluginConfig`, `PluginCapabilities`, `PluginMeta`
+
+### Dependency Injection Types (`dependencies.ts`)
+
+- **Design System**: `PluginDesignSystem`, `DesignSystemFont`, `DesignSystemColor`
+- **Spacing & Layout**: `DesignSystemSpacing`, `DesignSystemGrid`, `DesignSystemLayout`
+- **Utilities**: `PluginUtils`, `PluginRenderer`, `PluginRendererProps`
+- **Callbacks**: `PluginCallbacks`
+- **Complete DI**: `PluginDependencies`
+
+## Architecture
+
+This package follows the **Plugin-Driven Architecture** principle:
+
+- Plugins declare their own capabilities and requirements
+- The host application provides dependencies via dependency injection
+- Type safety is enforced at compile-time across all plugins
+
+## License
+
+MIT

package/dist/common-types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Common Type Definitions
+ *
+ * Single source of truth for types used across multiple plugins and packages.
+ * NO DUPLICATION - all plugins import from here.
+ *
+ * @package @codefluss/base-types
+ * @version 1.0.0
+ */
+/**
+ * Box model value for spacing (padding/margin)
+ * Used for both static and responsive spacing
+ */
+export interface BoxModelValue {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Viewport types for responsive design
+ * Only 3 breakpoints: mobile, tablet, desktop
+ */
+export type Viewport = 'mobile' | 'tablet' | 'desktop';
+/**
+ * Generic responsive values structure
+ * Enforces consistent viewport naming across the system
+ */
+export interface ResponsiveValues<T> {
+    mobile: T;
+    tablet: T;
+    desktop: T;
+}
+/**
+ * Responsive box model values
+ * Used for spacing presets and responsive overrides
+ */
+export type ResponsiveBoxValues = ResponsiveValues<BoxModelValue>;
+/**
+ * Text alignment options
+ */
+export type TextAlign = 'left' | 'center' | 'right' | 'justify';
+/**
+ * Font weight options
+ * Supports both named weights and numeric values
+ */
+export type FontWeight = 'normal' | 'medium' | 'semibold' | 'bold' | number;
+/**
+ * Text decoration options
+ */
+export type TextDecoration = 'none' | 'underline' | 'line-through';
+/**
+ * Text transform options
+ */
+export type TextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize';
+/**
+ * Vertical alignment options for content within element
+ * Uses flexbox for positioning
+ */
+export type VerticalAlign = 'start' | 'center' | 'end';
+/**
+ * Multi-language content structure
+ * Keys are ISO language codes (en, de, fr, es, it)
+ *
+ * Fallback chain:
+ * 1. Requested language
+ * 2. English ('en')
+ * 3. First available language
+ * 4. Empty string
+ */
+export interface MultiLangContent {
+    [languageCode: string]: string;
+}
+/**
+ * Responsive font sizes for different breakpoints
+ */
+export interface ResponsiveFontSizes {
+    mobile: string;
+    tablet: string;
+    desktop: string;
+}
+/**
+ * Common style properties shared across text-based components
+ */
+export interface TextStyleData {
+    fontPresetId?: string | null;
+    colorPresetId?: string | null;
+    backgroundColorPresetId?: string | null;
+    textAlign?: TextAlign | null;
+    verticalAlign?: VerticalAlign | null;
+    textDecoration?: TextDecoration | null;
+    textTransform?: TextTransform | null;
+    letterSpacing?: number | null;
+    maxWidth?: string | null;
+}
+/**
+ * Common layout properties shared across all components
+ */
+export interface LayoutData {
+    spacingPresetId: string;
+    spacingOverride?: {
+        margin?: BoxModelValue;
+        padding?: BoxModelValue;
+    } | null;
+    context?: 'default' | 'cards' | 'sections';
+}
+/**
+ * Grid placement properties for components in grid layouts
+ */
+export interface GridPlacementData {
+    colStart: number;
+    colSpan: number;
+    rowStart: number;
+    rowSpan: number;
+}
+/**
+ * Common advanced properties
+ */
+export interface AdvancedData {
+    className?: string;
+    ariaLabel?: string;
+}
+/**
+ * Resolved text styles after applying fallback chain
+ */
+export interface ResolvedTextStyles {
+    fontSize: string;
+    lineHeight: string;
+    fontWeight: string;
+    color: string;
+    textAlign: TextAlign;
+    textDecoration: TextDecoration;
+    textTransform: TextTransform;
+    letterSpacing: string;
+    maxWidth: string;
+    fontFamily: string;
+}
+//# sourceMappingURL=common-types.d.ts.map

package/dist/common-types.d.ts.map

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

package/dist/common-types.js

@@ -0,0 +1,11 @@
+/**
+ * Common Type Definitions
+ *
+ * Single source of truth for types used across multiple plugins and packages.
+ * NO DUPLICATION - all plugins import from here.
+ *
+ * @package @codefluss/base-types
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=common-types.js.map

package/dist/common-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-types.js","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/dependencies.d.ts

@@ -0,0 +1,487 @@
+/**
+ * Dependency Injection Types
+ *
+ * These types define the external dependencies that the plugin requires
+ * from the host application. All dependencies must be injected via props.
+ *
+ * @package @codefluss/base-types
+ * @version 1.0.0
+ */
+import type { ComponentType } from 'react';
+/**
+ * Responsive font size values for different breakpoints
+ */
+export interface ResponsiveFontSizes {
+    mobile: string;
+    tablet: string;
+    desktop: string;
+}
+/**
+ * Responsive line height values for different breakpoints
+ */
+export interface ResponsiveLineHeights {
+    mobile: number;
+    tablet: number;
+    desktop: number;
+}
+/**
+ * Design System Font Configuration
+ */
+export interface DesignSystemFont {
+    family: string;
+    size: string;
+    weight: string;
+    lineHeight: string;
+    element?: string;
+    responsive?: ResponsiveFontSizes;
+    responsiveLineHeight?: ResponsiveLineHeights;
+}
+/**
+ * Design System Color Configuration
+ */
+export interface DesignSystemColor {
+    value: string;
+    label: string;
+}
+/**
+ * Box Model Value - Single side values
+ */
+export interface BoxModelValue {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Grid Preset Values (Container-specific)
+ * Clean camelCase naming
+ */
+export interface GridPresetValues {
+    columns: number;
+    rows: number;
+    columnGap: number;
+    rowGap: number;
+    maxWidth: number;
+    margin: number | string;
+    alignmentHorizontal: string;
+    alignmentVertical: string;
+    alignmentContent: string;
+}
+/**
+ * Responsive spacing values for different breakpoints
+ * Only 3 viewports: mobile, tablet, desktop
+ */
+export interface ResponsiveBoxValues {
+    mobile: BoxModelValue;
+    tablet: BoxModelValue;
+    desktop: BoxModelValue;
+}
+/**
+ * Spacing Preset - Combined margin + padding with responsive values
+ */
+export interface SpacingPreset {
+    presetId: string;
+    name: string;
+    margin: ResponsiveBoxValues;
+    padding: ResponsiveBoxValues;
+}
+/**
+ * Responsive spacing scale entry
+ */
+export interface ResponsiveSpacingScale {
+    mobile: number;
+    tablet: number;
+    desktop: number;
+    unit: string;
+}
+/**
+ * Design System Spacing Configuration
+ * Clean, type-safe API
+ */
+export interface DesignSystemSpacing {
+    /** Spacing scale values */
+    scale: number[];
+    /** Responsive spacing scales by token */
+    scaleResponsive: Map<string, ResponsiveSpacingScale>;
+    /**
+     * Get a spacing preset by ID
+     * @param presetId - The preset identifier
+     * @returns The spacing preset (guaranteed to exist, falls back to 'default')
+     */
+    getPreset(presetId: string): SpacingPreset;
+}
+/**
+ * Design System Grid Configuration
+ * Clean, type-safe API
+ */
+export interface DesignSystemGrid {
+    /**
+     * Get a grid preset by ID
+     * @param presetId - The preset identifier
+     * @returns The grid preset values (guaranteed to exist, falls back to 'default')
+     */
+    getPreset(presetId: string): GridPresetValues;
+}
+/**
+ * Breakpoint configuration for responsive design
+ */
+export interface BreakpointConfig {
+    minWidth: number;
+    name: string;
+}
+/**
+ * Design System Breakpoints
+ */
+export interface DesignSystemBreakpoints {
+    mobile: BreakpointConfig;
+    tablet: BreakpointConfig;
+    desktop: BreakpointConfig;
+}
+/**
+ * Design System Layout Configuration
+ */
+export interface DesignSystemLayout {
+    maxWidth?: string;
+    gap?: string;
+    padding?: string;
+    margin?: string;
+}
+/**
+ * Button Style Preset Configuration (Unified)
+ *
+ * Complete button style preset that replaces the separate
+ * ButtonSizePreset and ButtonVariantPreset interfaces.
+ * Matches design_system_button_styles table structure.
+ */
+export interface ButtonStylePreset {
+    id: string;
+    presetId: string;
+    name: string;
+    size: string;
+    fontSizePresetId?: string;
+    fontWeight?: string;
+    spacingPresetId?: string;
+    borderRadiusPresetId?: string;
+    shadowPresetId?: string;
+    focusRingPresetId?: string;
+    animationPresetId?: string;
+    hoverEffectPresetId?: string;
+    backgroundColorPresetId?: string;
+    textColorPresetId?: string;
+    borderColorPresetId?: string;
+    hoverBackgroundColorPresetId?: string;
+    hoverTextColorPresetId?: string;
+    hoverBorderColorPresetId?: string;
+    activeBackgroundColorPresetId?: string;
+    activeTextColorPresetId?: string;
+    activeBorderColorPresetId?: string;
+    defaultTransitionDuration: number;
+    hoverTransitionDuration: number;
+    activeTransitionDuration: number;
+    disabledOpacity: number;
+    defaultTextDecoration?: string;
+    hoverTextDecoration?: string;
+    activeTextDecoration?: string;
+    defaultTextTransform?: string;
+    hoverTextTransform?: string;
+    activeTextTransform?: string;
+    usageDescription?: string;
+    isDefault: boolean;
+}
+/**
+ * @deprecated Use ButtonStylePreset instead
+ * Legacy Button Size Preset Configuration
+ */
+export interface ButtonSizePreset {
+    button_id: string;
+    name: string;
+    padding: string;
+    fontSize: string;
+    iconSize: string;
+    minHeight: string;
+    borderRadius?: string;
+    fontWeight?: string;
+    usage_description?: string;
+}
+/**
+ * @deprecated Use ButtonStylePreset instead
+ * Legacy Button Variant Preset Configuration
+ */
+export interface ButtonVariantPreset {
+    background: string;
+    hoverBackground: string;
+    textColor: string;
+    borderColor: string;
+}
+/**
+ * Shadow Configuration
+ */
+export interface ShadowConfig {
+    value: string;
+    dark?: string;
+}
+/**
+ * Accordion Style Preset Configuration
+ *
+ * Complete accordion style preset for collapsible components.
+ * Matches design_system_accordion_presets table structure.
+ */
+export interface AccordionStylePreset {
+    id: string;
+    presetId: string;
+    name: string;
+    headerHeight?: string;
+    headerFontSizePresetId?: string;
+    headerFontWeight?: string;
+    headerPaddingPresetId?: string;
+    headerBackgroundColorPresetId?: string;
+    headerHoverBackgroundColorPresetId?: string;
+    headerTextColorPresetId?: string;
+    headerBorderColorPresetId?: string;
+    bodyMinHeight?: string;
+    bodyPaddingPresetId?: string;
+    bodyBackgroundColorPresetId?: string;
+    bodyBorderColorPresetId?: string;
+    borderRadiusPresetId?: string;
+    shadowPresetId?: string;
+    spacingPresetId?: string;
+    transitionDuration: number;
+    transitionEasing?: string;
+    expandedBackgroundColorPresetId?: string;
+    expandedTextColorPresetId?: string;
+    usageDescription?: string;
+    isDefault: boolean;
+}
+/**
+ * Form Style Preset Configuration (Unified)
+ *
+ * Complete form style preset that contains all styling for form elements.
+ * Matches design_system_form_styles table structure.
+ */
+export interface FormStylePreset {
+    id: string;
+    presetId: string;
+    name: string;
+    variant: string;
+    size: string;
+    fontSizePresetId?: string;
+    paddingX: number;
+    paddingY: number;
+    borderWidth: number;
+    borderRadiusPresetId?: string;
+    shadowPresetId?: string;
+    focusRingPresetId?: string;
+    animationPresetId?: string;
+    hoverEffectPresetId?: string;
+    backgroundColorPresetId?: string;
+    textColorPresetId?: string;
+    borderColorPresetId?: string;
+    placeholderColorPresetId?: string;
+    focusRingColorPresetId?: string;
+    hoverBackgroundColorPresetId?: string;
+    hoverBorderColorPresetId?: string;
+    disabledOpacity: number;
+    errorBorderColorPresetId?: string;
+    errorTextColorPresetId?: string;
+    submitButtonPresetId?: string;
+    containerBackgroundColorPresetId?: string;
+    containerSpacingPresetId?: string;
+    labelFontPresetId?: string;
+    labelColorPresetId?: string;
+    descriptionFontPresetId?: string;
+    descriptionColorPresetId?: string;
+    fieldGap?: number;
+    usageDescription?: string;
+    isDefault: boolean;
+}
+/**
+ * Design System API
+ *
+ * Interface for accessing global design system values.
+ * The host application must provide an implementation.
+ */
+export interface PluginDesignSystem {
+    fonts: {
+        getPreset: (presetId: string) => DesignSystemFont | undefined;
+    };
+    colors: {
+        getPreset: (presetId: string) => DesignSystemColor | undefined;
+    };
+    spacing: DesignSystemSpacing;
+    grid?: DesignSystemGrid;
+    layout: {
+        getPreset: (presetId: string) => DesignSystemLayout | undefined;
+    };
+    breakpoints: {
+        getConfig: () => DesignSystemBreakpoints;
+    };
+    /**
+     * Button System (optional)
+     * Provides unified button style presets from design system database
+     * Each preset contains colors, typography, spacing, and effects
+     */
+    buttons?: {
+        /**
+         * Get button style preset by ID
+         * @param presetId - Button preset identifier (e.g., 'primary', 'secondary', 'custom-1')
+         * @returns Button style preset or undefined if not found
+         */
+        getPreset: (presetId: string) => ButtonStylePreset | undefined;
+        /**
+         * List all available button style presets
+         * @returns Array of button style presets sorted by sort_order
+         */
+        listPresets?: () => ButtonStylePreset[];
+    };
+    /**
+     * Form System (optional)
+     * Provides unified form style presets from design system database
+     * Each preset contains colors, typography, spacing, and effects for form elements
+     */
+    forms?: {
+        /**
+         * Get form style preset by ID
+         * @param presetId - Form preset identifier (e.g., 'default', 'outlined', 'custom-1')
+         * @returns Form style preset or undefined if not found
+         */
+        getPreset: (presetId: string) => FormStylePreset | undefined;
+        /**
+         * List all available form style presets
+         * @returns Array of form style presets sorted by sort_order
+         */
+        listPresets?: () => FormStylePreset[];
+    };
+    /**
+     * Accordion System (optional)
+     * Provides unified accordion style presets from design system database
+     * Each preset contains colors, typography, spacing, and effects for accordion components
+     */
+    accordions?: {
+        /**
+         * Get accordion style preset by ID
+         * @param presetId - Accordion preset identifier (e.g., 'default', 'sm', 'lg', 'custom-1')
+         * @returns Accordion style preset or undefined if not found
+         */
+        getPreset: (presetId: string) => AccordionStylePreset | undefined;
+        /**
+         * List all available accordion style presets
+         * @returns Array of accordion style presets sorted by sort_order
+         */
+        listPresets?: () => AccordionStylePreset[];
+    };
+    /**
+     * Shadow System (optional)
+     * Provides shadow presets with light and dark mode variants
+     */
+    shadows?: {
+        getPreset: (presetId: string) => ShadowConfig;
+    };
+}
+/**
+ * Utility Functions API
+ *
+ * Interface for utility functions required by the plugin.
+ * The host application must provide implementations.
+ */
+export interface PluginUtils {
+    /**
+     * Class name utility (e.g., clsx, classnames, tailwind-merge)
+     * Combines multiple class names intelligently
+     */
+    cn: (...inputs: any[]) => string;
+}
+/**
+ * Plugin Renderer Props
+ *
+ * Props interface for the PluginRenderer component.
+ * This is injected by the host application to render child plugins.
+ */
+export interface PluginRendererProps {
+    /**
+     * Plugin ID to render (e.g., 'base-text', 'base-image')
+     */
+    pluginId: string;
+    /**
+     * Element ID for tracking
+     */
+    elementId: string;
+    /**
+     * Plugin data/configuration
+     */
+    data: Record<string, unknown>;
+    /**
+     * Current language code
+     */
+    language: string;
+    /**
+     * Is in editor mode?
+     */
+    isEditorMode?: boolean;
+    /**
+     * Is element selected?
+     */
+    isSelected?: boolean;
+    /**
+     * Click handler
+     */
+    onClick?: (id: string) => void;
+}
+/**
+ * Plugin Callbacks
+ *
+ * Event callbacks that plugins can use to communicate with the host application.
+ */
+export interface PluginCallbacks {
+    /**
+     * Called when content changes (for text, rich-text components)
+     * @param elementId - ID of the element
+     * @param language - Language code
+     * @param content - New content value
+     */
+    onContentChange?: (elementId: string, language: string, content: string) => void;
+    /**
+     * Called when child element is dropped into container
+     * @param containerId - ID of the container element
+     * @param droppedElementId - ID of the dropped element
+     * @param index - Optional insertion index
+     */
+    onChildAdded?: (containerId: string, droppedElementId: string, index?: number) => void;
+    /**
+     * Called when child element is removed from container
+     * @param containerId - ID of the container element
+     * @param removedElementId - ID of the removed element
+     */
+    onChildRemoved?: (containerId: string, removedElementId: string) => void;
+    /**
+     * Called when container layout is changed
+     * @param containerId - ID of the container element
+     * @param layoutMode - New layout mode
+     */
+    onLayoutChange?: (containerId: string, layoutMode: 'flexbox' | 'grid') => void;
+}
+/**
+ * Complete Plugin Dependencies
+ *
+ * All external dependencies that must be injected into the plugin.
+ * PLUGIN-DRIVEN ARCHITECTURE: Plugins receive dependencies from the host app.
+ */
+export interface PluginDependencies {
+    /**
+     * Design System API for accessing global design tokens
+     */
+    designSystem: PluginDesignSystem;
+    /**
+     * Utility functions (e.g., cn for classnames)
+     */
+    utils: PluginUtils;
+    /**
+     * PluginRenderer component for rendering child plugins
+     * CRITICAL: Container plugins need this to render their NESTED children
+     */
+    PluginRenderer: ComponentType<PluginRendererProps>;
+    /**
+     * Optional callbacks for communication with host app
+     */
+    callbacks?: PluginCallbacks;
+}
+//# sourceMappingURL=dependencies.d.ts.map