ferro_json_ui/
lib.rs

1//! # Ferro JSON-UI
2//!
3//! JSON-based server-driven UI schema types for the Ferro framework.
4//!
5//! This crate defines the v2 `Spec` foundation: a flat, ID-keyed element map
6//! with parse-time structural validation. Typed `*Props` structs describe
7//! per-component prop shape and feed the Phase 117 catalog via `JsonSchema`.
8//!
9//! ## Schema Structure
10//!
11//! A JSON-UI Spec consists of:
12//! - **Spec** - Top-level container: `$schema`, `root`, `elements`, `title?`, `layout?`, `data?`
13//! - **Element** - Single UI node: `type` (string), `props` (Value), `children` (`Vec<String>` of IDs), `action?`, `visible?`
14//! - **Actions** - Handler references with confirmations and outcomes
15//! - **Visibility** - Conditional rendering based on data conditions
16//!
17//! ## Example
18//!
19//! ```rust
20//! use ferro_json_ui::{Spec, Element};
21//!
22//! let spec = Spec::builder()
23//!     .title("Demo")
24//!     .element("root", Element::new("Text").prop("content", "Hi"))
25//!     .build()
26//!     .unwrap();
27//! ```
28
29pub mod action;
30pub mod assets;
31pub mod catalog;
32pub mod component;
33pub mod config;
34pub mod data;
35pub mod design;
36pub mod expression;
37pub mod layout;
38pub mod loader;
39pub mod plugin;
40pub mod plugins;
41pub mod render;
42pub mod resolve;
43pub mod spec;
44pub mod visibility;
45
46pub mod runtime;
47
48pub use action::{Action, ActionOutcome, ConfirmDialog, HttpMethod};
49pub use assets::leaflet::{leaflet_image, LEAFLET_CSS, LEAFLET_JS};
50#[cfg(not(feature = "dev-css"))]
51pub use assets::FERRO_BASE_CSS;
52pub use assets::{ferro_base_css, GEIST_MONO_WOFF2, GEIST_OFL_TXT, GEIST_SANS_WOFF2};
53pub use component::{
54    ActionCardProps, ActionGroupProps, ActionItem, AlertProps, AvatarProps, BadgeProps,
55    BreadcrumbItem, BreadcrumbProps, ButtonGroupProps, ButtonProps, ButtonType, CardAppearance,
56    CardProps, CheckboxListProps, CheckboxProps, ChecklistItem, ChecklistProps, CollapsibleProps,
57    Column, ColumnFormat, DataTableProps, DescriptionItem, DescriptionListProps,
58    DropdownMenuAction, EmptyStateProps, FormMaxWidth, FormProps, FormSectionProps, GapSize,
59    GridProps, HeaderProps, IconPosition, ImageProps, InputProps, InputType, KanbanBoardProps,
60    KanbanColumnProps, ModalProps, NotificationDropdownProps, NotificationItem, Orientation,
61    PageHeaderProps, PaginationProps, ProgressProps, RawHtmlProps, RichTextEditorProps,
62    SegmentedControlProps, SegmentedItem, SelectOption, SelectProps, SeparatorProps, SidebarGroup,
63    SidebarLayoutItem, SidebarLayoutProps, SidebarNavItem, SidebarProps, Size, SkeletonProps,
64    SortDirection, StatCardProps, SwitchProps, Tab, TableProps, TabsProps, TextElement, TextProps,
65    TileProps, ToastProps, Tone, Variant,
66};
67pub use config::JsonUiConfig;
68pub use design::{lint, rules, DesignMeta, DesignRule, Finding, Severity, KNOWN_INTENTS};
69pub use runtime::FERRO_RUNTIME_JS;
70// resolve_path and resolve_path_string are pub(crate) — internal render pipeline helpers
71pub use layout::{
72    register_layout, render_layout, DashboardLayout, DashboardLayoutConfig, Layout, LayoutContext,
73    LayoutRegistry, NavItem, SidebarSection,
74};
75// AppLayout, AuthLayout, DefaultLayout are pub in layout.rs but not user-facing — users select
76// layouts by name string ("dashboard", "app", "auth"), not by struct.
77// navigation, sidebar, footer, global_registry are framework-internal.
78pub use catalog::{global_catalog, Catalog, CatalogError, ComponentSpec};
79pub use expression::resolve_expressions;
80pub use loader::{load_cached, LoadError};
81pub use plugin::{
82    collect_plugin_assets, global_plugin_registry, register_plugin, registered_plugin_types,
83    with_plugin, Asset, CollectedAssets, JsonUiPlugin, PluginRegistry,
84};
85pub use plugins::{register_built_in_plugins, MapPlugin, RichTextEditorPlugin};
86pub use render::{
87    render_spec_to_html, render_spec_to_html_with_plugins, render_subtree, RenderResult,
88};
89pub use resolve::{
90    expand_directives, resolve_actions, resolve_actions_strict, resolve_errors, resolve_errors_all,
91};
92pub use spec::{
93    DataRef, Element, ElementBuilder, Spec, SpecBuilder, SpecError, TitleBinding,
94    MAX_NESTING_DEPTH, SCHEMA_VERSION,
95};
96pub use visibility::{Visibility, VisibilityCondition, VisibilityOperator};
97
98#[cfg(feature = "projections")]
99pub mod projection;
100
101#[cfg(feature = "projections")]
102pub use projection::{JsonUiRenderer, ProjectionError, RenderMode, VisualContext};
103
104#[cfg(feature = "projections")]
105pub use projection::intent_layout::{default_template, register_template};
ferro_json_ui/lib.rs

ferro_json_ui/
lib.rs
