@codefluss/base-types 0.0.1-alpha.1

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@codefluss/base-types",
+  "version": "0.0.1-alpha.1",
+  "description": "Shared type definitions for Codefluss Page Builder plugins",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "codefluss",
+    "page-builder",
+    "plugin",
+    "types",
+    "typescript"
+  ],
+  "author": "Codefluss",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}

package/src/common-types.ts

@@ -0,0 +1,154 @@
+/**
+ * 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;
+}