@almadar/ui 5.25.1 → 5.26.1

package/dist/components/core/atoms/FlipContainer.d.ts

@@ -1,8 +1,8 @@
 /**
- * FlipContainer - A 3D perspective container atom for flip animations.
- *
- * Provides CSS 3D transform infrastructure: perspective on the outer wrapper,
- * preserve-3d + rotateY on the inner, and backface-visibility hidden on each child face.
+ * FlipContainer — CSS 3D perspective atom (distinct from FlipCard molecule).
+ * Owns perspective/preserve-3d/rotateY only. Children are the raw face elements.
+ * Use FlipCard when you need standard card chrome; use FlipContainer when you
+ * need the flip mechanic around custom face content.
  */
 import React from 'react';
 export interface FlipContainerProps {

package/dist/components/core/atoms/Icon.d.ts

@@ -13,8 +13,10 @@
  */
 import React from 'react';
 import type { LucideIcon } from 'lucide-react';
+import type { ColorToken } from './types';
 export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 export type IconAnimation = 'spin' | 'pulse' | 'none';
+export type { ColorToken };
 /**
  * Resolve an icon name to a Lucide icon component.
  * Supports all 1500+ Lucide icons via dynamic PascalCase lookup.
@@ -32,8 +34,8 @@ export interface IconProps {
     name?: string;
     /** Size of the icon */
     size?: IconSize;
-    /** Color class (Tailwind color class) or 'inherit' for theme default */
-    color?: string;
+    /** Semantic palette token or an arbitrary Tailwind color class. */
+    color?: ColorToken | string;
     /** Animation type */
     animation?: IconAnimation;
     /** Additional CSS classes */

package/dist/components/core/atoms/ProgressBar.d.ts

@@ -5,7 +5,7 @@
  */
 import React from "react";
 export type ProgressBarType = "linear" | "circular" | "stepped";
-export type ProgressBarVariant = "default" | "primary" | "success" | "warning" | "danger";
+export type ProgressBarVariant = "default" | "primary" | "success" | "warning" | "error" | "danger";
 export type ProgressBarColor = ProgressBarVariant;
 export interface ProgressBarProps {
     /**

package/dist/components/core/atoms/svg/SvgBranch.d.ts

@@ -1,12 +1,16 @@
 import React from 'react';
 export interface SvgBranchProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     variant?: 'fork' | 'merge' | 'diamond';
     branches?: number;
     size?: number;
     color?: string;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgBranch: React.FC<SvgBranchProps>;

package/dist/components/core/atoms/svg/SvgConnection.d.ts

@@ -1,13 +1,17 @@
 import React from 'react';
 export interface SvgConnectionProps {
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
+    x1?: number;
+    y1?: number;
+    x2?: number;
+    y2?: number;
     variant?: 'solid' | 'dashed' | 'animated';
     color?: string;
     strokeWidth?: number;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgConnection: React.FC<SvgConnectionProps>;

package/dist/components/core/atoms/svg/SvgFlow.d.ts

@@ -1,10 +1,14 @@
 import React from 'react';
 export interface SvgFlowProps {
-    points: Array<[number, number]>;
+    points?: Array<[number, number]>;
     color?: string;
     strokeWidth?: number;
     animated?: boolean;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgFlow: React.FC<SvgFlowProps>;

package/dist/components/core/atoms/svg/SvgGrid.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 export interface SvgGridProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     cols?: number;
     rows?: number;
     spacing?: number;
@@ -10,5 +10,9 @@ export interface SvgGridProps {
     opacity?: number;
     className?: string;
     highlights?: number[];
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgGrid: React.FC<SvgGridProps>;

package/dist/components/core/atoms/svg/SvgLobe.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 export interface SvgLobeProps {
-    cx: number;
-    cy: number;
+    cx?: number;
+    cy?: number;
     rx?: number;
     ry?: number;
     rotation?: number;
@@ -9,5 +9,9 @@ export interface SvgLobeProps {
     color?: string;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgLobe: React.FC<SvgLobeProps>;

package/dist/components/core/atoms/svg/SvgMesh.d.ts

@@ -1,12 +1,16 @@
 import React from 'react';
 export interface SvgMeshProps {
-    cx: number;
-    cy: number;
+    cx?: number;
+    cy?: number;
     nodes?: number;
     radius?: number;
     color?: string;
     connectionDensity?: number;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgMesh: React.FC<SvgMeshProps>;

package/dist/components/core/atoms/svg/SvgMorph.d.ts

@@ -1,11 +1,15 @@
 import React from 'react';
 export interface SvgMorphProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     size?: number;
     variant?: 'text-to-code' | 'code-to-app' | 'generic';
     color?: string;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgMorph: React.FC<SvgMorphProps>;

package/dist/components/core/atoms/svg/SvgNode.d.ts

@@ -1,12 +1,16 @@
 import React from 'react';
 export interface SvgNodeProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     r?: number;
     variant?: 'filled' | 'stroked' | 'pulse';
     color?: string;
     opacity?: number;
     className?: string;
     label?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgNode: React.FC<SvgNodeProps>;

package/dist/components/core/atoms/svg/SvgPulse.d.ts

@@ -1,12 +1,16 @@
 import React from 'react';
 export interface SvgPulseProps {
-    cx: number;
-    cy: number;
+    cx?: number;
+    cy?: number;
     rings?: number;
     maxRadius?: number;
     color?: string;
     animated?: boolean;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgPulse: React.FC<SvgPulseProps>;

package/dist/components/core/atoms/svg/SvgRing.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 export interface SvgRingProps {
-    cx: number;
-    cy: number;
+    cx?: number;
+    cy?: number;
     r?: number;
     variant?: 'solid' | 'dashed' | 'glow';
     color?: string;
@@ -9,5 +9,9 @@ export interface SvgRingProps {
     opacity?: number;
     className?: string;
     label?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgRing: React.FC<SvgRingProps>;

package/dist/components/core/atoms/svg/SvgShield.d.ts

@@ -1,11 +1,15 @@
 import React from 'react';
 export interface SvgShieldProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     size?: number;
     variant?: 'outline' | 'filled' | 'check';
     color?: string;
     opacity?: number;
     className?: string;
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    width?: number;
+    height?: number;
 }
 export declare const SvgShield: React.FC<SvgShieldProps>;

package/dist/components/core/atoms/svg/SvgStack.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 export interface SvgStackProps {
-    x: number;
-    y: number;
+    x?: number;
+    y?: number;
     layers?: number;
     width?: number;
     height?: number;
@@ -9,5 +9,9 @@ export interface SvgStackProps {
     opacity?: number;
     className?: string;
     labels?: string[];
+    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
+    asRoot?: boolean;
+    svgWidth?: number;
+    svgHeight?: number;
 }
 export declare const SvgStack: React.FC<SvgStackProps>;

package/dist/components/core/atoms/types.d.ts

@@ -1,6 +1,12 @@
 /**
  * Cross-cutting atom-level prop shapes shared across the design system.
  */
+/**
+ * Canonical semantic color palette.  Values are the Tailwind / CSS-var token
+ * names that every component in the design system understands.  Prefer this
+ * over a bare `string` for any `color` or `variant` prop.
+ */
+export type ColorToken = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'muted';
 /**
  * Concrete error-state shape read by display components (`error.message`,
  * occasionally `error.stack`). Structurally assignable from the global `Error`,

package/dist/components/core/molecules/ArrayEditor.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { TraitConfigValue } from '@almadar/core';
+export interface ArrayEditorProps {
+    /** Current array value. */
+    value: ReadonlyArray<TraitConfigValue>;
+    /** Fired when the array changes. */
+    onChange: (next: ReadonlyArray<TraitConfigValue>) => void;
+    /** Additional CSS classes. */
+    className?: string;
+}
+/**
+ * ArrayEditor — edits a `ReadonlyArray<TraitConfigValue>` with add / remove per row.
+ * Each row infers its editor from the element's runtime type.
+ */
+export declare const ArrayEditor: React.FC<ArrayEditorProps>;

package/dist/components/core/molecules/Carousel.d.ts

@@ -7,7 +7,13 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-export interface CarouselProps<T = Record<string, unknown>> {
+/** Default shape for carousel slide items when no generic is provided. */
+export interface CarouselItem {
+    id?: string;
+    title?: string;
+    image?: string;
+}
+export interface CarouselProps<T = CarouselItem> {
     /** Array of items to display as slides */
     items: T[];
     /** Render function for each slide */
@@ -33,4 +39,4 @@ export interface CarouselProps<T = Record<string, unknown>> {
     /** Additional CSS classes */
     className?: string;
 }
-export declare const Carousel: <T = Record<string, unknown>>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, }: CarouselProps<T>) => React.ReactElement | null;
+export declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, }: CarouselProps<T>) => React.ReactElement | null;

package/dist/components/core/molecules/Container.d.ts

@@ -1,8 +1,8 @@
 /**
- * Container Component
- *
- * A max-width wrapper that centers content horizontally.
- * Essential for controlling page width and maintaining consistent margins.
+ * Container — max-width centering wrapper (distinct from Box).
+ * Box controls padding/margin/bg/shadow on an arbitrary element.
+ * Container constrains page width and centers; use it at the layout level,
+ * not as a generic div replacement.
  */
 import React from 'react';
 export type ContainerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';

package/dist/components/core/molecules/DateRangeSelector.d.ts

@@ -1,8 +1,7 @@
 /**
- * DateRangeSelector Molecule Component
- *
- * Button group for selecting time range periods.
- * Pure UI molecule with no entity binding.
+ * DateRangeSelector — preset period button-group (e.g. 1W / 1M / 3M / 1Y).
+ * Distinct from DateRangePicker: no calendar inputs, no custom dates.
+ * Use DateRangePicker when the user needs to enter an arbitrary from/to range.
  */
 import React from 'react';
 export interface DateRangeSelectorOption {

package/dist/components/core/molecules/DocSidebar.d.ts

@@ -1,8 +1,8 @@
 /**
- * DocSidebar Molecule Component
- *
- * A documentation navigation sidebar with collapsible category sections.
- * Composes from Box, VStack, HStack, Typography, and Icon atoms.
+ * DocSidebar — collapsible documentation navigation sidebar.
+ * Renders a nested item tree with expand/collapse per category and active-item
+ * highlighting. Not a generic nav; it owns doc-site-specific UX (uppercase
+ * category headers, indented children, active highlight).
  */
 import React from 'react';
 export interface DocSidebarItem {

package/dist/components/core/molecules/EdgeDecoration.d.ts

@@ -15,6 +15,7 @@
  * sides of the parent container.
  */
 import React from 'react';
+import type { ColorToken } from '../atoms/types';
 export type EdgeVariant = 'arch' | 'vine' | 'lattice';
 export type EdgeSide = 'left' | 'right' | 'both';
 export interface EdgeDecorationProps {
@@ -24,8 +25,8 @@ export interface EdgeDecorationProps {
     side?: EdgeSide;
     /** Overall opacity (default: 0.15) */
     opacity?: number;
-    /** Stroke color */
-    color?: string;
+    /** Semantic palette token or a raw CSS color value for the stroke. */
+    color?: ColorToken | string;
     /** Stroke width */
     strokeWidth?: number;
     /** Width of the decoration area as percentage of container (default: 15) */

package/dist/components/core/molecules/Flex.d.ts

@@ -1,8 +1,8 @@
 /**
- * Flex Component
- *
- * A flexbox wrapper with all common flex properties exposed as props.
- * More explicit than Stack for when you need full flex control.
+ * Flex — full-surface flexbox primitive (distinct from Stack).
+ * Stack covers the 95% case (VStack/HStack with gap/align/justify).
+ * Flex exposes direction, wrap, grow, shrink, basis individually; use it
+ * when you need those extra axes or inline-flex behavior.
  */
 import React from 'react';
 export type FlexDirection = 'row' | 'row-reverse' | 'col' | 'col-reverse';

package/dist/components/core/molecules/FlipCard.d.ts

@@ -1,8 +1,7 @@
 /**
- * FlipCard - A two-sided card with 3D flip animation.
- *
- * Pure presentational molecule: no entity binding, no event bus, no translations.
- * Uses the FlipContainer atom for the 3D transform mechanics.
+ * FlipCard — two-sided card molecule with front/back faces (distinct from FlipContainer).
+ * FlipContainer is the raw 3D-transform atom; FlipCard wraps it with card styling,
+ * absolute face positioning, and `front`/`back` ReactNode props for lolo consumers.
  */
 import React from 'react';
 export interface FlipCardProps {

package/dist/components/core/molecules/GradientDivider.d.ts

@@ -5,9 +5,10 @@
  * Used between major sections for visual separation without hard background-color breaks.
  */
 import React from 'react';
+import type { ColorToken } from '../atoms/types';
 export interface GradientDividerProps {
-    /** Override the center color (CSS value). Defaults to var(--color-primary). */
-    color?: string;
+    /** Semantic palette token or a raw CSS color value. Defaults to 'primary'. */
+    color?: ColorToken | string;
     /** Additional class names */
     className?: string;
 }

package/dist/components/core/molecules/MapEditor.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { TraitConfigObject } from '@almadar/core';
+export interface MapEditorProps {
+    /** Current map value (object used as string-keyed map). */
+    value: TraitConfigObject;
+    /** Fired when an entry is added, removed, or its key/value is changed. */
+    onChange: (next: TraitConfigObject) => void;
+    /** Additional CSS classes. */
+    className?: string;
+}
+/**
+ * MapEditor — edits a `TraitConfigObject` as a dynamic key/value map.
+ * Unlike ObjectEditor (fixed schema keys), MapEditor allows adding/removing entries
+ * and renaming keys.
+ */
+export declare const MapEditor: React.FC<MapEditorProps>;

package/dist/components/core/molecules/ObjectEditor.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { TraitConfigObject } from '@almadar/core';
+export interface ObjectEditorProps {
+    /** Current object value. */
+    value: TraitConfigObject;
+    /** Fired when any field changes. */
+    onChange: (next: TraitConfigObject) => void;
+    /** Additional CSS classes. */
+    className?: string;
+}
+/**
+ * ObjectEditor — edits a `TraitConfigObject` showing one labeled row per key.
+ * Keys are fixed (derived from the current object's shape).
+ */
+export declare const ObjectEditor: React.FC<ObjectEditorProps>;

package/dist/components/core/molecules/SidePanel.d.ts

@@ -1,8 +1,8 @@
 /**
- * SidePanel Molecule Component
- *
- * A side panel that slides in from the right (or left) with header and content.
- * Uses Button, Typography atoms.
+ * SidePanel — fixed side panel for contextual detail on top of the page layout.
+ * Distinct from Drawer: Drawer is driven by the UI Slot system (render_ui drawer)
+ * and is generic. SidePanel is a direct-render component with its own close event
+ * API, used where the panel is always present in the component tree.
  */
 import React from "react";
 import type { EventEmit } from "@almadar/core";

package/dist/components/core/molecules/SortableList.d.ts

@@ -1,9 +1,8 @@
 /**
- * SortableList Molecule
- *
- * A list where items can be dragged to reorder via drag handles.
- * Uses useDragReorder for drag state management and useEventBus for event emission.
- * Shows a drop indicator line at the target position during drag.
+ * SortableList — drag-to-reorder list (distinct from DataList).
+ * DataList is a read/action list with no drag. SortableList owns drag
+ * handles and emits a REORDER event with fromIndex/toIndex/item — use it
+ * when item ordering is user-controlled.
  */
 import React from 'react';
 import type { EntityRow, EventKey, EventPayload } from "@almadar/core";

package/dist/components/core/molecules/ViolationAlert.d.ts

@@ -1,13 +1,8 @@
 /**
- * ViolationAlert
- *
- * Displays inspection violations with law references and action types.
- * Used in inspection forms to show detected compliance violations.
- *
- * Action Types:
- * - measure: Corrective measure required (warning)
- * - admin: Administrative action (error)
- * - penalty: Penalty proceedings (error, severe)
+ * ViolationAlert — domain-specific compliance violation display (distinct from Alert).
+ * Alert is a generic dismissible message. ViolationAlert owns structured
+ * `ViolationRecord` (law/article/actionType/adminAction/penaltyAction) and
+ * an optional "navigate to field" action — use it in inspection/compliance forms only.
  */
 import React from "react";
 export type ViolationRecord = {

package/dist/components/core/molecules/index.d.ts

@@ -1,4 +1,7 @@
 export { ErrorBoundary, type ErrorBoundaryProps } from './ErrorBoundary';
+export { ArrayEditor, type ArrayEditorProps } from './ArrayEditor';
+export { ObjectEditor, type ObjectEditorProps } from './ObjectEditor';
+export { MapEditor, type MapEditorProps } from './MapEditor';
 export { FileTree, type FileTreeProps, type FileTreeNode } from './FileTree';
 export { FormField, type FormFieldProps } from './FormField';
 export { EmptyState, type EmptyStateProps } from './EmptyState';
@@ -33,7 +36,7 @@ export { Drawer, type DrawerProps, type DrawerPosition, type DrawerSize } from '
 export { WizardProgress, type WizardProgressProps, type WizardProgressStep } from './WizardProgress';
 export { WizardNavigation, type WizardNavigationProps } from './WizardNavigation';
 export { MarkdownContent, type MarkdownContentProps } from './markdown/MarkdownContent';
-export { CodeBlock, type CodeBlockProps, type CodeLanguage } from './markdown/CodeBlock';
+export { CodeBlock, type CodeBlockProps, type CodeLanguage, type CodeViewerMode, type DiffLine, type CodeViewerFile, type CodeViewerAction, toCodeLanguage, } from './markdown/CodeBlock';
 export { QuizBlock, type QuizBlockProps } from './QuizBlock';
 export { ScaledDiagram, type ScaledDiagramProps } from './ScaledDiagram';
 export { CalendarGrid, type CalendarGridProps } from './CalendarGrid';
@@ -97,7 +100,6 @@ export { ReplyTree, type ReplyTreeProps } from './ReplyTree';
 export { BranchingLogicBuilder, type BranchingLogicBuilderProps, type BranchingQuestion, type BranchingRule } from './BranchingLogicBuilder';
 export { VersionDiff, type VersionDiffProps, type DiffRevision, type DiffLine as VersionDiffLine, type DiffLineType } from './VersionDiff';
 export { DocBreadcrumb, type DocBreadcrumbProps, type DocBreadcrumbItem } from './DocBreadcrumb';
-export { DocCodeBlock, type DocCodeBlockProps } from './DocCodeBlock';
 export { DocPagination, type DocPaginationProps, type DocPaginationLink } from './DocPagination';
 export { DocSearch, type DocSearchProps, type DocSearchResult } from './DocSearch';
 export { DocSidebar, type DocSidebarProps, type DocSidebarItem } from './DocSidebar';
@@ -124,4 +126,3 @@ export { Chart, type ChartProps, type ChartType, type ChartSeries, } from "./Cha
 export { SignaturePad, type SignaturePadProps, } from "./SignaturePad";
 export { DocumentViewer, type DocumentViewerProps, type DocumentType, } from "./DocumentViewer";
 export { GraphCanvas, type GraphCanvasProps, type GraphNode, type GraphEdge, } from "./GraphCanvas";
-export { CodeViewer, type CodeViewerProps, type CodeViewerMode, type DiffLine, } from "./CodeViewer";

package/dist/components/core/molecules/markdown/CodeBlock.d.ts

@@ -8,6 +8,7 @@
  * - Emits: UI:COPY_CODE { language, success }
  */
 import React from 'react';
+import type { UiError } from '../../atoms/types';
 /**
  * The set of languages with a registered PrismLight grammar (above) plus the
  * `.orb`/`.lolo` grammars from `@almadar/syntax`. Authoritative: an unregistered
@@ -22,9 +23,26 @@ export type CodeLanguage = (typeof CODE_LANGUAGES)[number];
  * grammar — matching the highlighter's own plain-text fallback.
  */
 export declare function toCodeLanguage(value: string | undefined): CodeLanguage;
+export type CodeViewerMode = 'code' | 'diff';
+export interface DiffLine {
+    type: 'add' | 'remove' | 'context';
+    content: string;
+    lineNumber?: number;
+}
+export interface CodeViewerAction {
+    label: string;
+    event?: string;
+    navigatesTo?: string;
+    variant?: 'primary' | 'secondary' | 'ghost';
+}
+export interface CodeViewerFile {
+    label: string;
+    code: string;
+    language?: CodeLanguage;
+}
 export interface CodeBlockProps {
     /** The code content to display */
-    code: string;
+    code?: string;
     /** Programming language for syntax highlighting */
     language?: CodeLanguage;
     /** Show the copy button */
@@ -32,7 +50,7 @@ export interface CodeBlockProps {
     /** Show the language badge */
     showLanguageBadge?: boolean;
     /** Maximum height before scrolling */
-    maxHeight?: string;
+    maxHeight?: string | number;
     /** Enable brace-based code folding of multi-line `{}`/`[]` blocks (default: true). */
     foldable?: boolean;
     /** Additional CSS classes */
@@ -62,5 +80,29 @@ export interface CodeBlockProps {
      * path → line map from the schema + validation results.
      */
     errorLines?: Map<number, 'error' | 'warning'>;
+    /** Title shown in the toolbar */
+    title?: string;
+    /** Diff or plain-code display mode */
+    mode?: CodeViewerMode;
+    /** Pre-computed diff lines */
+    diff?: readonly DiffLine[];
+    /** Old source text — generates diff when combined with newValue */
+    oldValue?: string;
+    /** New source text — generates diff when combined with oldValue */
+    newValue?: string;
+    /** Show line numbers in code / diff mode */
+    showLineNumbers?: boolean;
+    /** Enable word-wrap in code / diff mode */
+    wordWrap?: boolean;
+    /** Multiple files shown as tabs */
+    files?: readonly CodeViewerFile[];
+    /** Action badges in the toolbar */
+    actions?: readonly CodeViewerAction[];
+    /** Loading state */
+    isLoading?: boolean;
+    /** Error state */
+    error?: UiError | null;
+    /** Show copy button (viewer alias for showCopyButton) */
+    showCopy?: boolean;
 }
 export declare const CodeBlock: React.NamedExoticComponent<CodeBlockProps>;

package/dist/components/core/molecules/markdown/MarkdownContent.d.ts

@@ -18,8 +18,8 @@ import 'katex/dist/katex.min.css';
 export interface MarkdownContentProps {
     /** The markdown content to render */
     content: string;
-    /** Text direction */
-    direction?: 'rtl' | 'ltr';
+    /** Text direction (defaults to ltr; `ltr` is first so the generated config seeds it) */
+    direction?: 'ltr' | 'rtl';
     /** Additional CSS classes */
     className?: string;
 }