@codefluss/base-types 0.0.1-alpha.1 → 0.0.2-alpha.2

package/dist/common-types.d.ts

@@ -2,137 +2,364 @@
  * Common Type Definitions
  *
  * Single source of truth for types used across multiple plugins and packages.
- * NO DUPLICATION - all plugins import from here.
+ * **NO DUPLICATION** — all plugins import from here.
+ *
+ * These types cover responsive design, text styling, layout, and
+ * common data structures shared by the entire plugin system.
+ *
+ * @see {@link ResponsiveValues} — Generic responsive wrapper
+ * @see {@link TextStyleData} — Shared text styling properties
+ * @see {@link LayoutData} — Shared layout / spacing properties
  *
  * @package @codefluss/base-types
  * @version 1.0.0
  */
 /**
- * Box model value for spacing (padding/margin)
- * Used for both static and responsive spacing
+ * Four-sided box model value for spacing (padding / margin / gap).
+ *
+ * Each property represents a side's spacing in pixels (unitless number).
+ * Used for both static and responsive spacing presets.
+ *
+ * @see {@link ResponsiveBoxValues} for per-viewport variants
+ *
+ * @example
+ * ```typescript
+ * const padding: BoxModelValue = { top: 16, right: 24, bottom: 16, left: 24 };
+ * ```
  */
 export interface BoxModelValue {
+    /** Top spacing in pixels */
     top: number;
+    /** Right spacing in pixels */
     right: number;
+    /** Bottom spacing in pixels */
     bottom: number;
+    /** Left spacing in pixels */
     left: number;
 }
 /**
- * Viewport types for responsive design
- * Only 3 breakpoints: mobile, tablet, desktop
+ * Viewport breakpoint identifiers for responsive design.
+ *
+ * The system uses exactly **three** breakpoints:
+ * - `'mobile'` — Small screens (≤ 768px)
+ * - `'tablet'` — Medium screens (769px – 1024px)
+ * - `'desktop'` — Large screens (≥ 1025px)
+ *
+ * @see {@link ResponsiveValues} for responsive value wrappers
  */
 export type Viewport = 'mobile' | 'tablet' | 'desktop';
 /**
- * Generic responsive values structure
- * Enforces consistent viewport naming across the system
+ * Generic responsive values structure — wraps any type `T` with
+ * per-viewport entries.
+ *
+ * Enforces consistent viewport naming across the entire system.
+ *
+ * @template T - The value type held at each breakpoint
+ *
+ * @see {@link Viewport} for the three breakpoints
+ * @see {@link ResponsiveBoxValues} for the `BoxModelValue` specialization
+ *
+ * @example
+ * ```typescript
+ * const fontSizes: ResponsiveValues<string> = {
+ *   mobile: '1rem',
+ *   tablet: '1.25rem',
+ *   desktop: '1.5rem',
+ * };
+ *
+ * const columns: ResponsiveValues<number> = {
+ *   mobile: 1,
+ *   tablet: 2,
+ *   desktop: 3,
+ * };
+ * ```
  */
 export interface ResponsiveValues<T> {
+    /** Value applied on mobile viewports */
     mobile: T;
+    /** Value applied on tablet viewports */
     tablet: T;
+    /** Value applied on desktop viewports */
     desktop: T;
 }
 /**
- * Responsive box model values
- * Used for spacing presets and responsive overrides
+ * Responsive box model values — {@link BoxModelValue} for each viewport.
+ *
+ * Used by spacing presets and responsive overrides to define per-breakpoint
+ * margin / padding values.
+ *
+ * @see {@link BoxModelValue}
+ * @see {@link ResponsiveValues}
  */
 export type ResponsiveBoxValues = ResponsiveValues<BoxModelValue>;
 /**
- * Text alignment options
+ * CSS `text-align` options for horizontal text alignment.
+ *
+ * @see {@link TextStyleData.textAlign}
  */
 export type TextAlign = 'left' | 'center' | 'right' | 'justify';
 /**
- * Font weight options
- * Supports both named weights and numeric values
+ * Font weight options.
+ *
+ * Supports named weights and numeric CSS values (100–900).
+ *
+ * @see {@link ResolvedTextStyles.fontWeight}
  */
 export type FontWeight = 'normal' | 'medium' | 'semibold' | 'bold' | number;
 /**
- * Text decoration options
+ * CSS `text-decoration` options.
+ *
+ * @see {@link TextStyleData.textDecoration}
  */
 export type TextDecoration = 'none' | 'underline' | 'line-through';
 /**
- * Text transform options
+ * CSS `text-transform` options.
+ *
+ * @see {@link TextStyleData.textTransform}
  */
 export type TextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize';
 /**
- * Vertical alignment options for content within element
- * Uses flexbox for positioning
+ * Vertical alignment options for content within an element.
+ *
+ * Applied via flexbox `align-items` / `align-self`.
+ *
+ * @see {@link TextStyleData.verticalAlign}
  */
 export type VerticalAlign = 'start' | 'center' | 'end';
 /**
- * Multi-language content structure
- * Keys are ISO language codes (en, de, fr, es, it)
+ * Multi-language content map.
  *
- * Fallback chain:
+ * Keys are ISO language codes (`'en'`, `'de'`, `'fr'`, `'es'`, `'it'`).
+ * Values are the localized text strings.
+ *
+ * **Fallback chain** when resolving content:
  * 1. Requested language
- * 2. English ('en')
+ * 2. English (`'en'`)
  * 3. First available language
  * 4. Empty string
+ *
+ * @example
+ * ```typescript
+ * const content: MultiLangContent = {
+ *   en: 'Hello World',
+ *   de: 'Hallo Welt',
+ *   fr: 'Bonjour le monde',
+ * };
+ * ```
  */
 export interface MultiLangContent {
     [languageCode: string]: string;
 }
 /**
- * Responsive font sizes for different breakpoints
+ * Responsive font sizes — CSS size strings for each viewport breakpoint.
+ *
+ * @see {@link ResponsiveValues}
+ *
+ * @example
+ * ```typescript
+ * const sizes: ResponsiveFontSizes = {
+ *   mobile: '1rem',
+ *   tablet: '1.25rem',
+ *   desktop: '1.5rem',
+ * };
+ * ```
  */
 export interface ResponsiveFontSizes {
+    /** Font size on mobile viewports (CSS value) */
     mobile: string;
+    /** Font size on tablet viewports (CSS value) */
     tablet: string;
+    /** Font size on desktop viewports (CSS value) */
     desktop: string;
 }
 /**
- * Common style properties shared across text-based components
+ * Common text style properties shared across text-based plugin components
+ * (heading, paragraph, text, button label, etc.).
+ *
+ * All fields are optional — `null` means "inherit from Design System preset".
+ *
+ * @see {@link ResolvedTextStyles} for the resolved (non-nullable) result
+ *
+ * @example
+ * ```typescript
+ * const style: TextStyleData = {
+ *   fontPresetId: 'heading-1',
+ *   colorPresetId: 'foreground',
+ *   textAlign: 'center',
+ *   letterSpacing: 0.5,
+ * };
+ * ```
  */
 export interface TextStyleData {
+    /**
+     * Design System font preset ID (e.g., `'heading-1'`, `'body'`).
+     * Resolves to font family, size, weight, and line-height via the Design System.
+     * @default null (inherit)
+     */
     fontPresetId?: string | null;
+    /**
+     * Design System color preset ID for the text foreground color.
+     * @default null (inherit)
+     */
     colorPresetId?: string | null;
+    /**
+     * Design System color preset ID for the element background color.
+     * @default null (transparent)
+     */
     backgroundColorPresetId?: string | null;
+    /**
+     * Horizontal text alignment
+     * @default null (inherit)
+     * @see {@link TextAlign}
+     */
     textAlign?: TextAlign | null;
+    /**
+     * Vertical alignment within the element (via flexbox)
+     * @default null (inherit)
+     * @see {@link VerticalAlign}
+     */
     verticalAlign?: VerticalAlign | null;
+    /**
+     * Text decoration (underline, line-through, or none)
+     * @default null (inherit)
+     * @see {@link TextDecoration}
+     */
     textDecoration?: TextDecoration | null;
+    /**
+     * Text transform (uppercase, lowercase, capitalize, or none)
+     * @default null (inherit)
+     * @see {@link TextTransform}
+     */
     textTransform?: TextTransform | null;
+    /**
+     * Letter spacing in pixels (can be negative)
+     * @default null (inherit)
+     */
     letterSpacing?: number | null;
+    /**
+     * Maximum width of the text element (CSS value, e.g., `'600px'`, `'none'`)
+     * @default null (no constraint)
+     */
     maxWidth?: string | null;
 }
 /**
- * Common layout properties shared across all components
+ * Common layout properties shared across all plugin components.
+ *
+ * Handles spacing (via preset system) and optional overrides.
+ *
+ * @see {@link BoxModelValue} for the override value shape
+ *
+ * @example
+ * ```typescript
+ * const layout: LayoutData = {
+ *   spacingPresetId: 'spacing-text-default',
+ *   spacingOverride: {
+ *     padding: { top: 8, right: 16, bottom: 8, left: 16 },
+ *   },
+ *   context: 'default',
+ * };
+ * ```
  */
 export interface LayoutData {
+    /**
+     * ID of the Design System spacing preset applied to this element.
+     * Resolves to responsive margin and padding values.
+     */
     spacingPresetId: string;
+    /**
+     * Per-element overrides that take precedence over the spacing preset.
+     * Set to `null` to clear overrides and use the preset values as-is.
+     */
     spacingOverride?: {
+        /** Override margin values */
         margin?: BoxModelValue;
+        /** Override padding values */
         padding?: BoxModelValue;
     } | null;
+    /**
+     * Layout context hint — influences how spacing presets are resolved.
+     *
+     * - `'default'` — Standard page content
+     * - `'cards'` — Inside a card component (tighter spacing)
+     * - `'sections'` — Page section level (wider spacing)
+     *
+     * @default 'default'
+     */
     context?: 'default' | 'cards' | 'sections';
 }
 /**
- * Grid placement properties for components in grid layouts
+ * Grid placement data for components inside CSS Grid containers.
+ *
+ * Specifies the column/row position and span of an element
+ * within its parent grid.
+ *
+ * @example
+ * ```typescript
+ * // Element spanning columns 1-2 in row 1
+ * const placement: GridPlacementData = {
+ *   colStart: 1,
+ *   colSpan: 2,
+ *   rowStart: 1,
+ *   rowSpan: 1,
+ * };
+ * ```
  */
 export interface GridPlacementData {
+    /** 1-based column start position (`grid-column-start`) */
     colStart: number;
+    /** Number of columns to span (`grid-column-end: span N`) */
     colSpan: number;
+    /** 1-based row start position (`grid-row-start`) */
     rowStart: number;
+    /** Number of rows to span (`grid-row-end: span N`) */
     rowSpan: number;
 }
 /**
- * Common advanced properties
+ * Advanced properties available on all plugin components.
+ *
+ * These are typically shown in the "Advanced" section of the Context Panel.
  */
 export interface AdvancedData {
+    /**
+     * Additional CSS class names applied to the root element.
+     * @default ''
+     */
     className?: string;
+    /**
+     * ARIA label for accessibility (screen readers).
+     * @default ''
+     */
     ariaLabel?: string;
 }
 /**
- * Resolved text styles after applying fallback chain
+ * Fully resolved text styles after applying the Design System fallback chain.
+ *
+ * All values are guaranteed to be non-null CSS-ready strings.
+ * Produced by resolving a {@link TextStyleData} against the active
+ * Design System font and color presets.
+ *
+ * @see {@link TextStyleData} for the unresolved (nullable) input
  */
 export interface ResolvedTextStyles {
+    /** Resolved CSS `font-size` value (e.g., `'1.5rem'`, `'24px'`) */
     fontSize: string;
+    /** Resolved CSS `line-height` value (e.g., `'1.4'`, `'28px'`) */
     lineHeight: string;
+    /** Resolved CSS `font-weight` value (e.g., `'700'`, `'bold'`) */
     fontWeight: string;
+    /** Resolved CSS color value (e.g., `'#1a1a1a'`, `'rgb(0,0,0)'`) */
     color: string;
+    /** Resolved horizontal text alignment @see {@link TextAlign} */
     textAlign: TextAlign;
+    /** Resolved text decoration @see {@link TextDecoration} */
     textDecoration: TextDecoration;
+    /** Resolved text transform @see {@link TextTransform} */
     textTransform: TextTransform;
+    /** Resolved CSS `letter-spacing` value (e.g., `'0.5px'`, `'normal'`) */
     letterSpacing: string;
+    /** Resolved CSS `max-width` value (e.g., `'600px'`, `'none'`) */
     maxWidth: string;
+    /** Resolved CSS `font-family` value (e.g., `'"Inter", sans-serif'`) */
     fontFamily: string;
 }
 //# sourceMappingURL=common-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"common-types.d.ts","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"common-types.d.ts","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":"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"}

package/dist/common-types.js

@@ -2,7 +2,14 @@
  * Common Type Definitions
  *
  * Single source of truth for types used across multiple plugins and packages.
- * NO DUPLICATION - all plugins import from here.
+ * **NO DUPLICATION** — all plugins import from here.
+ *
+ * These types cover responsive design, text styling, layout, and
+ * common data structures shared by the entire plugin system.
+ *
+ * @see {@link ResponsiveValues} — Generic responsive wrapper
+ * @see {@link TextStyleData} — Shared text styling properties
+ * @see {@link LayoutData} — Shared layout / spacing properties
  *
  * @package @codefluss/base-types
  * @version 1.0.0

package/dist/common-types.js.map

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