facebook/litho
62.5
Adequate · 13 November 2026
250.4k
lines of production code
Kotlin
with Java
7
measurements over time
What this system is
Features
Added FirstDrawReporter tooling for tracking first content draw
A new \FirstDrawReporter\ utility has been added to the Litho core tools package, allowing developers to hook into the first draw event of a component. This feature introduces a \useFirstDrawReporter\ hook and a corresponding \Style.reportFirstContentDraw\ style prop, enabling precise measurement of time-to-first-content-draw (TTRC) by triggering a callback immediately after the initial render cycle completes.
litho-core/src/main/java/com/facebook/litho/tools · high confidence
Added ParamNameExtractor utility for method parameter extraction
A new ParamNameExtractor class has been added to the litho-processor module. This utility provides a static method to retrieve the names of parameters from executable elements, supporting internal processing logic within the Litho spec model processor.
litho-processor/src/main/java8 · high confidence
Added testing processor for generic Litho specs
A new \TestingGenericComponentProcessor\ has been added to the Litho integration test processor module to facilitate testing of generic specs. This processor, registered via the \META-INF/services\ SPI file, extends \AbstractComponentsProcessor\ and supports \LayoutSpec\, \MountSpec\, and \TestSpec\ annotations. It is intended for internal testing purposes only, as the generated code is not suitable for production use.
litho-it/processor · high confidence
Expanded accessibility styling options in Litho
The \AccessibilityStyles.kt\ file introduces a comprehensive set of new Style methods for configuring accessibility properties on Litho components. Users can now explicitly set focus order, control screen reader focusability, define live regions, and specify pane and container titles. Additional props include state descriptions, labeled-by relationships, minimum duration between content changes, and detailed role/heading configurations, providing finer control over how components are presented to accessibility services.
litho-core/src/main/java/com/facebook/litho/accessibility · high confidence
Initial open-source release of litho-sections-core
The litho-sections-core module is now available as a standalone open-source component, providing the core implementation for Litho Sections. This release includes the foundational classes for managing section trees and data diffs, such as ChangeSet, Change, and BatchedTarget, along with the necessary build configuration (BUCK) and AndroidManifest to support integration into Android applications.
litho-sections-core · high confidence
Initial release of the Litho RenderCore library
This change introduces the \litho-rendercore\ module, a new standalone library extracted from the main Litho codebase. It provides the core rendering engine, including the \RenderTree\, \RenderUnit\, and \HostView\ infrastructure, along with essential utilities like \Dimen\ for dimension handling, \LayoutCache\ for performance optimization, and \ContentAllocator\ for managing mountable content pools. The module is built in Kotlin, targets SDK 33, and includes the \BinderObserver\ API for tracking binder lifecycle events.
litho-rendercore · high confidence
Initial release of the Litho Sections Widget module
This change introduces the \litho-sections-widget\ module, providing the core components for building complex, section-based lists in Litho. It includes \RecyclerCollectionComponentSpec\ as the primary entry point, along with configuration classes like \ListRecyclerConfiguration\, \GridRecyclerConfiguration\, and \RecyclerBinderConfiguration\ to customize layout managers, snapping behavior, and background change sets. The module also provides event controllers (\RecyclerCollectionEventsController\) for programmatic scrolling and refreshing, as well as specialized item animators (\NoUpdateItemAnimator\, \NotAnimatedItemAnimator\) to control update animations.
litho-sections-widget · high confidence
Introduce Litho Zoomable component for nested scroll and gesture support
The litho-zoomable module now provides a new ZoomableComponent that enables pinch-to-zoom and pan gestures on Litho content while correctly handling nested scrolling. This change introduces LithoZoomableController and LithoZoomableView to manage the zoom state and touch events, allowing developers to embed zoomable Litho trees within scrollable containers without gesture conflicts.
litho-zoomable · high confidence
Introduce RenderCore SimpleList and background layout preparation
This release adds a new \SimpleList\ component to RenderCore, providing a \ListRenderUnit\ backed by a custom \RCRecyclerView\ that supports list, grid, and staggered grid layouts, along with scroll control, snap helpers, and item decorations. It includes a \BackgroundPreparer\ to offload layout preparation to a dedicated background thread with configurable priority and cancellation support, and a \SimpleListAdapter\ that uses \DiffUtil\ for efficient list updates. The Kotlin compiler plugin is updated with a \LithoGradlePlugin\ and \Kotlin22Compat\ layer to support Kotlin 2.2, and CMake defaults are standardized to C++20 with strict warning and optimization flags.
(repo-wide) · high confidence
Introduce RenderCore Text library for advanced text rendering
This change introduces the new \litho-rendercore-text\ library, providing a comprehensive text rendering solution built on the RenderCore primitives. It includes the \RCTextView\ view, which supports rich text features such as clickable and long-clickable spans, accessibility integration, and custom drawing via \OnPrePostDrawSpan\. The library also introduces \RichTextPrimitive\ for declarative text composition, \RoundedBackgroundColorSpan\ for styled backgrounds, and robust text truncation logic with caching. Additionally, it provides \TextAlignment\ and \TextStyle\ configurations for fine-grained control over text layout, alignment, and appearance.
litho-rendercore-text · high confidence
Introduce dedicated annotation processor for DiffSectionSpec and GroupSectionSpec
The litho-sections-processor module now provides a dedicated code-generation pipeline for Section specs, separating them from the general Component processor. This includes new model classes (DiffSectionSpecModel, GroupSectionSpecModel) and generators (DefaultDiffSectionSpecGenerator, DefaultGroupSectionSpecGenerator) that handle the specific lifecycle methods and delegate signatures for Sections. The processor validates Section-specific constraints, such as prohibiting @OnCreateLayout in DiffSectionSpecs, and generates the necessary boilerplate for service handling, cached values, and trigger methods. Also in this area: Introduce spec models and generators for DiffSection and GroupSection.
litho-sections-processor · high confidence
Introduce experimental dependency-aware transitions for Kotlin components
Kotlin components can now use the experimental \useTransition\ hook with a \deps\ parameter to define transitions that re-evaluate when specific props, states, or derived values change. This allows animations to trigger dynamically based on dependency changes, with the \diffOf\ API providing previous and current values for precise animation control. The change also introduces internal data structures (\KRenderData\, \TransitionCreator\) to manage transition state and dependencies, and adds utility components like \ExpandToReveal\ and \CrossFade\ that demonstrate these new transition capabilities.
litho-core/src/main/java/com/facebook/litho/transition · high confidence
Introduce litho-testing module with new testing utilities and build targets
The litho-testing module is introduced to centralize UI testing capabilities for Litho components. This change adds a new BUCK build configuration defining the module structure, including a main library target and a separate benchmark helper target. It introduces new testing utilities such as \BaseMatcher\ and \BaseMatcherBuilder\ for verifying component properties like click handlers and focus states, \BenchmarkTestHelper\ for measuring component lifecycle performance, and \TestPerfEvent\ for capturing performance metrics during tests. Additionally, it provides \TempComponentsConfigurations\ to allow tests to temporarily override global Litho settings, and \LifecycleStep\ to track component lifecycle events. Also in this area: New Litho view-tree testing utilities; New testing utilities for accessibility, animations, and collections.
litho-testing · high confidence
Introduces LifecycleOwnerWrapper to support deferred lifecycle observation
A new LifecycleOwnerWrapper class has been added to the Litho core lifecycle package. This component allows LiveData observers to be registered before a concrete LifecycleOwner is available, buffering them until a delegate is set. This enables use-live-data scenarios where the lifecycle owner is determined asynchronously, ensuring observers are correctly attached once the owner is resolved.
litho-core/src/main/java/com/facebook/litho/lifecycle · high confidence
Introduces state read tracking infrastructure for Litho components
This change adds a new internal state-read tracking system to Litho, introducing classes such as ComponentState, StateId, StateProvider, StateReadRecorder, and UiStateReadRecords. These components enable the framework to record which state values are accessed during specific UI phases (like bind and draw) and within specific scopes. This capability allows Litho to optimize execution by identifying exactly which binders or draw hosts need to be re-bound or invalidated when state changes, and includes mechanisms to detect and report or crash on invalid cross-tree state reads.
litho-core/src/main/java/com/facebook/litho/state · high confidence
Introduces the Incremental Mount extension for RenderCore
Adds a new \IncrementalMount\ module that provides a \RenderCoreExtension\ and \MountExtension\ to enable incremental mounting and gap-worker-based premounting. The extension introduces a \GapWorkerMode\ configuration (including \COST\_AWARE\_PREMOUNT\ and \COST\_AWARE\_PREMOUNT\_WITH\_INCREMENTAL\_UNMOUNT\) to control how the background worker schedules work within frame budgets, and includes a \CostAwarePremountScan\ to limit inspection per frame. It also adds an \ExcludeFromIncrementalMountBinder\ and a corresponding resource ID to allow specific components to opt out of this behavior. Also in this area: 2 commits (0 fixes) modifying litho-rendercore-incremental-mount.
litho-rendercore-incremental-mount/src/main/java · medium confidence · unverified
Introduces the Primitive API for lightweight, framework-agnostic UI components
A new \Primitive\ class is added to the \litho-rendercore-primitives\ module, providing a lightweight building block for UI components that can be shared across frameworks like Bloks and Litho. This API allows developers to define a \layoutBehavior\ (specifying how the component sizes and lays out children) and a \mountBehavior\ (specifying how to allocate and configure a \View\ or \Drawable\). The module includes supporting classes such as \LayoutScope\, \BindScope\, \ContentAllocator\, and \KBinder\ to facilitate this declarative, immutable component model.
litho-rendercore-primitives · high confidence
Litho Editor Flipper plugin adds mounting, visibility, and state inspection
The new \litho-editor-flipper\ module integrates the Litho Editor with the Flipper Layout Inspector, enabling developers to inspect and modify Litho component properties, state, and layout data directly. This update introduces specific descriptors for \LithoView\, \DebugComponent\, \DebugSection\, and \LithoRecyclerView\ to expose their internal structure. A key behavioral change is the inclusion of mounting and visibility information in the inspector, allowing users to see if a component is mounted and currently visible. Additionally, the plugin now supports editing state for Kotlin components via \KStateContainer\ and provides a command to force accessibility rendering for all Litho views.
litho-editor-flipper/src/main/java · high confidence
Litho annotation processor introduces new spec models and generators
The Litho annotation processor now includes a comprehensive set of new model classes and generators to support advanced spec features. This adds models for dynamic props (BindDynamicValueMethod, DiffPropModel, DiffStateParamModel), cached values (CachedValueParamModel), and builder methods (BuilderMethodModel), along with dedicated validation logic for these features (CachedValueValidation, DiffValidation, DynamicPropsValidation, FieldsValidation). It also introduces new generators for layout and mount specs (DefaultLayoutSpecGenerator, DefaultMountSpecGenerator) and synthetic error handling (ErrorEventHandlerGenerator), while providing helper utilities for Kotlin compatibility (KotlinSpecHelper) and lifecycle argument typing (LifecycleMethodArgumentType).
litho-processor/src/main/java/com/facebook/litho/specmodels/model · high confidence
Litho compiler plugin registration and auto-dependency configuration
The Litho compiler plugin is now registered with the Kotlin compiler via standard service loader files (CommandLineProcessor and CompilerPluginRegistrar), enabling automatic integration. Additionally, a default configuration file (litho-autodeps.conf) is introduced to define how the plugin infers dependencies from lambda closures, specifying which types to ignore (e.g., ComponentContext), expand, or treat as stable, thereby controlling the automatic dependency analysis behavior for users.
litho-compiler-plugin · high confidence
New Android setup, codemod, and local deployment scripts
Added three new shell scripts to streamline development workflows: \android-setup.sh\ configures the Android SDK environment (including proxy support to avoid SSL handshake issues) and installs specific platform and build tools; \codemod-state-update-methods.sh\ automates the conversion of state update calls to their synchronous variants for Kotlin and Java specs; and \local-deploy.sh\ builds the project and installs the resulting JAR and AAR artifacts into a local Maven repository for easy local consumption.
scripts · high confidence
New DebugSection class for UI inspector integration
The litho-sections-debug module now includes a new DebugSection class and its corresponding AndroidManifest. This class exposes section hierarchy information (such as global keys, names, bounds, and state containers) to external debugging tools like Flipper and Stetho, allowing them to visualize the Litho component tree more accurately. It specifically handles the distinction between DiffSectionSpec children (views) and GroupSectionSpec children (nested sections).
litho-sections-debug · high confidence
New Kotlin coroutine hooks for Litho components
This release introduces a set of Kotlin-specific hooks to integrate Kotlin Coroutines and Flows into Litho components. Developers can now use \useCoroutine\ to launch background tasks tied to component lifecycle, \useComponentCoroutineScope\ to obtain a lifecycle-aware scope for event-driven coroutines, and \useProducer\ to drive state updates from suspend functions. Additionally, \useFlow\ and \useFlowWithLifecycle\ allow components to reactively consume StateFlow emissions, with lifecycle-aware collection support, while \useFlowBinding\ enables direct binding of flows to animated properties like Style.alpha.
litho-coroutines-kotlin/src/main/kotlin/com/facebook/litho · high confidence
New Kotlin-based Yoga JNI bindings for Android
The Yoga library now provides a new Kotlin API layer for Android, introducing classes such as YogaNode, YogaConfig, and YogaNodeFactory to manage layout nodes and their configuration. This change adds a comprehensive set of generated Kotlin enums (e.g., YogaAlign, YogaFlexDirection) and helper interfaces (e.g., YogaMeasureFunction, YogaLogger) that wrap the underlying native Yoga core, enabling developers to interact with the layout engine using idiomatic Kotlin syntax on Android.
lib/yoga/java · high confidence
New Kotlin-based animation and dynamic style APIs in Litho
The \litho-core\ animation module has been rewritten in Kotlin, introducing a new \Animated\ object that provides \timing\ and \timingArgb\ methods for value and color animations, as well as \spring\, \sequence\, \parallel\, \stagger\, \loop\, and \delay\ composition helpers. A new \Easing\ object exposes standard interpolators and Bezier curve support. The \Style\ API now includes \rotationX\, \rotationY\, and \translationZ\ extension functions to support 3D transforms, alongside existing dynamic style properties like \alpha\, \backgroundColor\, and \elevation\. Additionally, the \useBinding\ hook allows components to create and manage \DynamicValue\ instances for imperative property updates and animation driving.
litho-core/src/main/java/com/facebook/litho/animated · high confidence
New Litho Kotlin file templates for Events, Components, and Sections
The IntelliJ plugin now provides new file templates for Litho Kotlin development, including KComponent, PrimitiveComponent, Event, and GroupSectionSpec. These templates generate boilerplate code for creating Kotlin-based Litho components, handling events, and defining section hierarchies, with specific support for modern Kotlin APIs and SizeConstraints in primitive components.
litho-intellij-plugin/src/main/resources/fileTemplates · high confidence
New Litho debug infrastructure and overlay for tracking layout threads
This change introduces a new debug reporting API and visual overlay within the Litho core library to help developers identify performance issues, specifically layouts executing on the main thread. The new \DebugInfoReporter\ and \LithoDebugEvent\ classes provide structured logging for various lifecycle events (such as resolve, render, and tree future operations) with optional stack traces. Additionally, the \DebugOverlay\ component draws a visual indicator in the UI to show the history of layout resolutions, using red and green rectangles to distinguish between main-thread and background-thread layouts, aiding in the detection of jank caused by synchronous state updates or main-thread rendering.
litho-core/src/main/java/com/facebook/litho/debug · high confidence
New Litho debugging tools for main-thread renders and mount performance
Added two new debug event subscribers in the litho-tooling module to help identify performance issues. The MainThreadRenderSourcesDebugger detects and reports renders forced to the main thread, distinguishing between cases where the main thread layout state is missing versus when it mismatches the measured size specs. The MountUiDebugger provides visual feedback by flashing an overlay on the LithoView based on mount duration (green for good, yellow for medium, red for bad) and drawing colored borders around render units as they are mounted (yellow), unmounted (red), or updated (green).
litho-tooling · high confidence
New Section lifecycle and rendering annotations
The \litho-sections-annotations\ module now includes a comprehensive set of new annotations to define Section behavior and lifecycle. \DiffSectionSpec\ and \GroupSectionSpec\ serve as the primary markers for generating ChangeSets and defining nested section hierarchies, respectively. Lifecycle management is handled by \OnCreateService\ and \OnBindService\ for service initialization, \OnUnbindService\ for cleanup, and \OnDataBound\ for visibility notifications. Rendering and data handling are supported by \OnDiff\ for generating change sets, \OnDataRendered\ for post-render callbacks (including global offset), \OnViewportChanged\ for scroll state updates, \OnRefresh\ for content refresh requests, and \OnVerifyChangeSet\ for validating change sets to prevent duplicate item errors.
litho-sections-annotations · high confidence
New annotation processor generators for cached values, render data diffs, and inter-stage props
The Litho annotation processor now includes dedicated generators for several advanced component features. CachedValueGenerator produces code for @OnCalculateCachedValue methods, creating input classes and getters that use global keys for cache resolution. RenderDataGenerator implements lifecycle support for Diff\<T\> parameters, generating methods to record and apply previous render data. InterStagePropsContainerGenerator and PrepareInterStagePropsPropsContainerGenerator create container classes for passing props between layout and mount stages. Additionally, MountSpecGenerator now generates hasChildLithoViews (renamed from canMountIncrementally), poolSize, canPreallocate, and isMountSizeDependent methods, while ClassAnnotationsGenerator ensures generated components properly suppress rawtype warnings and include @Generated annotations.
litho-processor/src/main/java/com/facebook/litho/specmodels/generator · high confidence
New experimental Litho permissions hook
The litho-permissions module introduces a new \usePermission\ hook that allows Litho components to request and observe Android permission status. This API, marked as experimental, provides a \PermissionState\ to track whether a permission is granted, denied, or permanently denied, and handles lifecycle-aware updates and activity result registration automatically.
litho-permissions · high confidence
New experimental and unconditional API annotations introduced
Litho now provides two new annotations to help manage API stability and usage patterns. The \@ExperimentalLithoApi\ annotation marks declarations that are still experimental, warning users that their design may change or they may be deprecated in the future. The \@Unconditional\ annotation is a marker for methods whose identity depends on call order, enforcing that they must be called unconditionally (not inside control flow structures) and only from other \@Unconditional\ methods to prevent subtle bugs related to render state pairing.
litho-core/src/main/java/com/facebook/litho/annotations · high confidence
New primitive rendering utility types for blending, layers, and path styling
The \litho-rendercore-primitive-components/utils\ module now includes a set of Kotlin value classes (\BlendingMode\, \CanvasLayerType\, \FillRule\, \LineCap\, \LineJoin\) that provide a type-safe, cross-version abstraction for Android canvas drawing operations. These utilities allow developers to configure alpha compositing, layer types, path fill rules, and line styling in a consistent way, with built-in string parsing and automatic fallback to platform defaults where necessary.
litho-rendercore-primitive-components/utils · high confidence
New rendercore-thread-utils library with thread-priority inheritance and assertion utilities
This change introduces the new \litho-rendercore-thread-utils\ module, providing core threading utilities for the RenderCore library. It includes \PriorityInheritingFuture\, which automatically raises the priority of background threads when the main thread is blocked waiting for results, preventing UI jank. The module also exposes \ThreadUtils\ for main-thread assertions (\assertMainThread\), safe UI/background thread execution (\runOnUiThread\, \runOnBackgroundThread\), and thread-priority manipulation. Additionally, it adds \RenderCoreThreadUtilsConfig\ to control end-to-end test behavior and \FutureInstrumenter\ to allow external instrumentation of future tasks.
litho-rendercore-thread-utils · high confidence
New useLiveData hook for observing LiveData in Litho components
Developers can now observe Android LiveData streams directly within Litho Kotlin components using the new @Hook useLiveData. This hook automatically manages observation lifecycle based on the provided LifecycleOwner and allows for dependency-based cancellation, simplifying state synchronization between LiveData and Litho component state.
litho-live-data/src/main · high confidence
New visibility style APIs for Litho components
This change introduces a new set of visibility-related style APIs in Litho, allowing developers to register callbacks for component visibility states such as onVisible, onInvisible, onFocusedVisible, onUnfocusedVisible, onFullImpression, and onVisibilityChanged. It also adds support for defining visibility ratios (visibleHeightRatio, visibleWidthRatio) and explicitly setting component visibility (VISIBLE/INVISIBLE) via the new visibility() style. These APIs are marked as experimental and are intended to provide more granular control over when and how visibility events are triggered for components.
litho-core/src/main/java/com/facebook/litho/visibility · high confidence
Yoga layout engine core C++ implementation
This change introduces the core C++ implementation of the Yoga layout engine into the \lib/yoga/yoga\ directory. It provides the public C API headers and source files (including \YGConfig\, \YGNode\, \YGNodeStyle\, \YGEnums\, and \YGPixelGrid\) that allow applications to define flexbox and grid layouts, manage node hierarchies, and retrieve computed dimensions. The addition includes the build configuration (\CMakeLists.txt\) required to compile the library and supports features like pixel grid rounding, custom logging, and experimental layout errata for compatibility. Also in this area: 1 commit (0 fixes) modifying lib/yoga.
lib/yoga/yoga · low confidence · unverified
Removals
Removal of Litho Stetho integration build target
The build configuration for the Litho Stetho integration has been removed. The \lib/stetho/BUCK\ file, which previously defined the \stetho\ Java library and its dependency on the \stetho-jar\, has been deleted. This change eliminates the local build target for this specific integration, aligning with the removal of Litho Stetho integrations mentioned in the commit history.
lib/stetho · high confidence
Removal of Mockito v1 build definition
The BUCK build file for the Mockito library has been deleted, effectively removing the v1 build definition from the project. This change is part of a broader migration to Skylark and the removal of legacy Mockito v1 components.
lib/mockito · high confidence
Removal of Robolectric 3 build targets
The build configuration for Robolectric 3 has been removed from the project. This change eliminates the specific BUCK targets previously used for testing with Robolectric 3, indicating a shift away from this version in the testing infrastructure.
lib/robolectric3 · high confidence
Removal of debug-mode Components testing and Stetho integration utilities
The debug build variant no longer includes the legacy \com.facebook.components\ testing infrastructure and Stetho debugging helpers. Specifically, the \ComponentViewDescriptor\, \ComponentsDescriptorProvider\, \ComponentsStethoManagerIMPL\, \StethoHitTestAccumulator\, and related Stetho node classes have been removed, along with the entire \testing\ subpackage containing \ComponentTestHelper\, \ComponentsRule\, various \Test\*Component\ classes, and the \ComponentsTestRunner\. This eliminates the ability to use these specific legacy tools for unit testing Components or inspecting component hierarchies via Stetho in debug builds.
src/debug · high confidence
Removal of deprecated CSSLayout and Android support build targets
The build configuration for the \lib/android-support\ location has been cleaned up by deleting the \BUCK\ files for both \CSSLayoutDEPRECATED\ and \android-support\. This removes the build targets for the deprecated CSSLayout library and the bundled Android support libraries (including support-v4, support-annotations, recyclerview, and vector-drawable), indicating that these dependencies are no longer required or managed through this specific build definition.
lib/android-support · high confidence
Removal of legacy Litho annotation processor
The legacy annotation processor implementation located in \litho-processor/src/main/java/com/facebook/litho/processor\ has been removed. This change deletes the entire processor directory, including \AbstractComponentsProcessor.java\, \ComponentsProcessor.java\, and all associated helper classes (such as \MountSpecHelper\, \SpecHelper\, and various \MethodSpecBuilder\ utilities). Users relying on this specific processor module for code generation will need to migrate to the new \SpecModels\-based processor architecture.
litho-processor/src/main/java/com/facebook/litho/processor · high confidence
Removal of lib/powermock build definition
The BUCK build file for the lib/powermock module has been deleted, indicating that this specific library definition is no longer part of the build system. This change removes the build configuration for the powermock component entirely from this location.
lib/jni-hack · high confidence
Removal of litho-processor BUCK build file
The BUCK build configuration for the litho-processor module has been removed from the repository. This deletion eliminates the local build rules that previously defined the litho-processor java\_binary target and its dependencies, indicating that this specific module is no longer built or maintained within this location.
lib/android-all, lib/powermock, litho-processor · high confidence
Removal of local Android support library build rule
The BUCK build file for the lib/appcompat module has been deleted, removing the local android\_prebuilt\_aar rule that previously packaged the appcompat-v7-24.1.1.aar artifact. This indicates that the appcompat dependency is no longer built or managed within this specific location, likely having been moved to a different module or managed externally.
lib/appcompat · high confidence
Removal of local BUCK build file for textlayoutbuilder
The local BUCK build configuration for the textlayoutbuilder library has been removed. This file previously defined an android\_prebuilt\_aar target for version 1.0.0 and referenced a COMPONENTS\_VISIBILITY variable, indicating that the library is no longer built or managed via this specific local build rule.
lib/textlayoutbuilder · high confidence
Removal of local BUCK build files
The local BUCK build configuration files for the assertj and bcprov-jdk16 libraries have been removed from the repository. This change eliminates the local build definitions for these dependencies, likely reflecting a shift in how these libraries are managed or consumed within the build system.
lib/assertj · high confidence
Removal of local JSR-305 build definition
The local BUCK build file for the JSR-305 library has been removed, meaning the project no longer builds or bundles the JSR-305 annotations as a standalone prebuilt JAR target in this location.
lib/jsr-305 · high confidence
Removed BUCK build configuration for specmodels
The BUCK build file for the litho-processor specmodels module has been removed, eliminating the local build target that previously included definitions from COMPONENTS\_DEFS.
litho-processor/src/main/java/com/facebook/litho/specmodels · high confidence
Removed local BUCK build file for vtd-xml
The BUCK file in the lib/vtd-xml directory has been removed, indicating that the vtd-xml library is no longer built as a local component within this repository structure.
lib/vtd-xml · high confidence
Architecture
Introduction of ProcessorBase abstract class for annotation processors
A new abstract base class, ProcessorBase, has been added to the litho-processor module. This class extends javax.annotation.processing.AbstractProcessor and provides a standardized implementation for process() and getSupportedSourceVersion(), allowing concrete annotation processors to simply implement the processImpl() method. This change centralizes common processor boilerplate and ensures consistent source version handling across all annotation processors in the litho-processor component.
litho-processor/src/main/java/com/facebook/annotationprocessors · high confidence
Litho annotation processor refactored into specmodels with inter-stage prop name persistence
The Litho annotation processor has been restructured into the specmodels package, introducing a new \AbstractComponentsProcessor\ base class and a \SpecModelFactory\ interface to standardize how LayoutSpec and MountSpec models are extracted and generated. A key behavioral improvement is the addition of inter-stage prop name persistence via \PropNameInterStageStore\, which serializes prop names to \\_STRIPPED\_RESOURCES\ to ensure correct parameter naming across multi-module builds where Java bytecode might otherwise lose this information. The processor now also supports explicit \RunMode\ flags for ABI and TESTING builds, extracts \@OnBindDynamicValue\ and \@OnTrigger\ methods, and filters out internal or Kotlin-specific annotations to prevent them from polluting the generated component code.
litho-processor/src/main/java/com/facebook/litho/specmodels/processor · high confidence
Behavioural changes
1 commit (0 fixes) modifying litho-coroutines-kotlin/src/main/kotlin/com/facebook/litho/animation
A change to existing behaviour in litho-coroutines-kotlin/src/main/kotlin/com/facebook/litho/animation — 1 commit, 1 file: “Add coroutine animation ownership”.
litho-coroutines-kotlin/src/main/kotlin/com/facebook/litho/animation · medium confidence · unverified
1 commit (0 fixes) modifying litho-navigation
A change to existing behaviour in litho-navigation — 1 commit, 3 files: “Add LithoNavHost to render FoA Navigation back stacks”.
litho-navigation · medium confidence · unverified
10 commits (0 fixes) modifying litho-surface
A change to existing behaviour in litho-surface — 10 commits, 6 files: “Stop LithoHost from keeping destroyed Fragments reachable from their Activity”; “Sync with fbsource after the paused export”; “Run close actions without discarding a Result”; and 7 more.
litho-surface · medium confidence · unverified
12 commits (1 fix) modifying litho-core/src/main/java/com/facebook/litho/layout/internal
A change to existing behaviour in litho-core/src/main/java/com/facebook/litho/layout/internal — 12 commits (1 fix), 4 files: “A Layout's children carry per-child values as LayoutProps classes”; “Add the rule a root Layout resolves its box by”; “Separate state recording from tree validation”; and 9 more.
litho-core/src/main/java/com/facebook/litho/layout/internal · medium confidence · unverified
13 commits (1 fix) modifying canvas
A change to existing behaviour in canvas — 13 commits (1 fix), 7 files: “Sync with fbsource after the paused export”; “Nested transforms should be supported”; “Text outlines and native text drawing”; and 10 more.
canvas · medium confidence · unverified
18 commits (0 fixes) modifying sample-kotlin
A change to existing behaviour in sample-kotlin — 18 commits, 180 files: “Sync with fbsource after the paused export”; “litho sections+editor+samples: enable strict mode (6 targets)”; “Add queued completion callbacks”; and 15 more.
sample-kotlin · medium confidence · unverified
18 commits (4 fixes) modifying litho-fresco/src/main/java
A change to existing behaviour in litho-fresco/src/main/java — 18 commits (4 fixs), 4 files: “Sync with fbsource after the paused export”; “Fix license”; “Add support to FrescoImage for photo focus points (for cover photos)”; and 15 more.
litho-fresco/src/main/java · medium confidence · unverified
2 commits (0 fixes) modifying litho-intellij-plugin/src/main/java
A change to existing behaviour in litho-intellij-plugin/src/main/java — 2 commits, 85 files: “Sync with fbsource after the paused export”; “convert\_to\_sam\_interface: fbandroid/libraries/components/litho-intellij-plugin/src/main/java/com/facebook/litho/intellij/extensions/EventLogger.kt”.
litho-intellij-plugin/src/main/java · medium confidence · unverified
2 commits (0 fixes) modifying litho-rendercore-simplelist
A change to existing behaviour in litho-rendercore-simplelist — 2 commits, 4 files: “Add tests for today's RecyclerView touch and scroll bar”; “Add an off-by-default switch and a test pinning today's nested scroll report”. Also in this area: Introduce RenderCore SimpleList and background layout preparation.
litho-rendercore-simplelist · medium confidence · unverified
21 commits (1 fix) modifying litho-core/src/main/java/com/facebook/litho/layout
A change to existing behaviour in litho-core/src/main/java/com/facebook/litho/layout — 21 commits (1 fix), 10 files: “Replaces YogaDirection with LayoutDirection \[2/n\]”; “Sync with fbsource after the paused export”; “Renames nested tree to deferred node”; and 18 more.
litho-core/src/main/java/com/facebook/litho/layout · medium confidence · unverified
22 commits (2 fixes) modifying litho-core/src/main/java/com/facebook/litho/animation
A change to existing behaviour in litho-core/src/main/java/com/facebook/litho/animation — 22 commits (2 fixs), 46 files: “Remove AnimationFrameCallback in AnimationFrameDriver.kt”; “Add compat specs that keep Transition motion”; “Sync with fbsource after the paused export”; and 19 more.
litho-core/src/main/java/com/facebook/litho/animation · medium confidence · unverified
3 commits (0 fixes) modifying litho-rendercore-transitions/src/main/java/com/facebook/litho/dataflow
A change to existing behaviour in litho-rendercore-transitions/src/main/java/com/facebook/litho/dataflow — 3 commits, 22 files: “Sync with fbsource after the paused export”; “Move Transition related code to its own project \[part 1\]”; “fbandroid/libraries/rendercore/rendercore-transitions/src/main/java/com/facebook/litho/dataflow/GraphBinding.kt”.
litho-rendercore-transitions/src/main/java/com/facebook/litho/dataflow · medium confidence · unverified
3 commits (0 fixes) modifying sample-java
A change to existing behaviour in sample-java — 3 commits, 102 files: “Sync with fbsource after the paused export”; “litho sections+editor+samples: enable strict mode (6 targets)”; “Remove Fetcher in Fetcher.kt”.
sample-java · medium confidence · unverified
4 commits (0 fixes) modifying litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/common
A change to existing behaviour in litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/common — 4 commits, 2 files: “Sync with fbsource after the paused export”; “Implement FE hooks usage checkers”; “Infer dependency lists from lambda closures”; and 1 more.
litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/common · medium confidence · unverified
4 commits (0 fixes) modifying litho-rendercore-transitions/src/main/java/com/facebook/litho
A change to existing behaviour in litho-rendercore-transitions/src/main/java/com/facebook/litho — 4 commits, 15 files: “Sync with fbsource after the paused export”; “fbandroid/libraries/components/litho-rendercore-transitions/src/main/java/com/facebook/litho/AnimatableItem.java”; “rendercore-transitions warnings cleanup”; and 1 more.
litho-rendercore-transitions/src/main/java/com/facebook/litho · medium confidence · unverified
4 commits (0 fixes) modifying sample-common
A change to existing behaviour in sample-common — 4 commits, 19 files: “Sync with fbsource after the paused export”; “Remove unused @Prop parameters fbandroid/libraries/components/sample-common/src/main/java/com/facebook/samples/litho/common/animations/dynamicprops/SeekBarSpec.kt”; “Remove Fetcher in Fetcher.kt”; and 1 more.
sample-common · medium confidence · unverified
4 commits (1 fix) modifying litho-rendercore-transitions/src/main/java/com/facebook/litho/animation
A change to existing behaviour in litho-rendercore-transitions/src/main/java/com/facebook/litho/animation — 4 commits (1 fix), 19 files: “Sync with fbsource after the paused export”; “fbandroid/libraries/components/litho-rendercore-transitions/src/main/java/com/facebook/litho/animation/AnimatedProperty.java”; “fbandroid/libraries/components/litho-rendercore-transitions/src/main/java/com/facebook/litho/animation/AnimatedProperties.java”; and 1 more.
litho-rendercore-transitions/src/main/java/com/facebook/litho/animation · medium confidence · unverified
6 commits (1 fix) modifying litho-core/src/main/java/com/facebook/litho/effects
A change to existing behaviour in litho-core/src/main/java/com/facebook/litho/effects — 6 commits (1 fix), 4 files: “Sync with fbsource after the paused export”; “Remove \enableStateReadTracking\”; “Fix broken KDoc links to EffectHandler.EmptyRunnable”; and 3 more.
litho-core/src/main/java/com/facebook/litho/effects · medium confidence · unverified
6 commits (1 fix) modifying litho-core/src/main/java/com/facebook/litho/flexbox
A change to existing behaviour in litho-core/src/main/java/com/facebook/litho/flexbox — 6 commits (1 fix), 1 file: “Replaces YogaDirection with LayoutDirection \[2/n\]”; “Sync with fbsource after the paused export”; “Annotate nonnegative Style percentages”; and 3 more.
litho-core/src/main/java/com/facebook/litho/flexbox · medium confidence · unverified
7 commits (1 fix) modifying litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/k2
A change to existing behaviour in litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/k2 — 7 commits (1 fix), 5 files: “Sync with fbsource after the paused export”; “Register Fir checkers to compiler processor”; “Use native compiler, diagnostic and IR APIs”; and 4 more.
litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/k2 · medium confidence · unverified
8 commits (0 fixes) modifying litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/ir
A change to existing behaviour in litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/ir — 8 commits, 8 files: “Sync with fbsource after the paused export”; “Lane setup + 2.4.21 compilercompat bucket”; “Use native compiler, diagnostic and IR APIs”; and 5 more.
litho-compiler-plugin/compiler/src/main/kotlin/com/facebook/litho/ir · medium confidence · unverified
9 commits (0 fixes) modifying litho-rendercore-primitive-components/canvas/src/main
A change to existing behaviour in litho-rendercore-primitive-components/canvas/src/main — 9 commits, 5 files: “CanvasState: a gradient after a translucent color no longer inherits its alpha”; “Sync with fbsource after the paused export”; “Text outlines and native text drawing”; and 6 more.
litho-rendercore-primitive-components/canvas/src/main · medium confidence · unverified
9 commits (0 fixes) modifying repository
A change to existing behaviour in repository — 9 commits, 34 files: “Make FoaBackStack attach/detach owner-aware and expose an explicit "di”; “Sync with fbsource after the paused export”; “Add LithoNavHost to render FoA Navigation back stacks”; and 6 more.
repository · medium confidence · unverified
Added ProGuard rules to preserve Litho annotation usage
A new ProGuard configuration file has been added to the litho-annotations module to ensure that specific annotations and their associated code are preserved during minification. The rules keep the \@DoNotStrip\ and \@KeepGettersAndSetters\ interfaces themselves, prevent stripping of any class or member annotated with \@DoNotStrip\, and ensure that getter and setter methods are retained for classes annotated with \@KeepGettersAndSetters\. This guarantees that these annotations remain functional for other ProGuard rules and that the annotated code is not removed or obfuscated in a way that breaks functionality.
litho-annotations/src/main/java/com/facebook/proguard · high confidence
Compiler introduces automatic dependency inference and stricter hook usage checks
The Litho compiler plugin now automatically infers component dependencies by analyzing the closures of \@DepsFrom\ arguments, reducing the need for manual dependency declarations. This is supported by new diagnostics that enforce correct usage of \@AutoDeps\, \@Deps\, and \@DepsFrom\ annotations. Additionally, the compiler now enforces that hooks are only called from \render()\ or other \@Hook\ functions, providing clearer error messages for misuse.
compiler · high confidence
Core utility classes migrated to Kotlin
Several internal utility classes in the litho-core module, including IncrementalMountUtils, MeasureUtils, MapDiffUtils, StacktraceHelper, and VersionedAndroidApis, have been rewritten in Kotlin. This migration maintains the existing public API and behavior for users while modernizing the internal implementation.
litho-core/src/main/java/com/facebook/litho/utils · high confidence
Drawable comparison logic migrated to Kotlin
The drawable implementation classes in litho-core (including ComparableDrawable, ComparableColorDrawable, ComparableGradientDrawable, BorderColorDrawable, and ComparableDrawableWrapper) have been converted from Java to Kotlin. This change introduces a ComparableDrawable interface that allows drawables to be compared by content rather than reference, enabling more accurate equality checks for Litho's rendering and caching logic.
litho-core/src/main/java/com/facebook/litho/drawable · high confidence
Editor model types refactored to Kotlin data classes
The Litho editor's core model classes (EditorString, EditorNumber, EditorBool, EditorColor, EditorShape, and EditorPick) have been converted from standard Java-style classes to Kotlin data classes using the @DataClassGenerate annotation. This change simplifies the implementation of value types by automatically generating equals, hashCode, and toString methods, while maintaining the existing visitor pattern (EditorVisitor) and tree traversal capabilities (whenPrimitive, aggregate) defined in the EditorValue base class.
litho-editor-core/src/main/java/com/facebook/litho/editor/model · high confidence
Enable incremental annotation processing for Litho
The processor now supports incremental compilation by registering the ComponentsProcessor with the 'isolating' flag in the Gradle incremental annotation processors configuration. This change allows the build system to process only affected sources, improving build times. The standard Java SPI service file is also updated to include both the main ComponentsProcessor and the new ComponentsTestingProcessor.
litho-processor/src/main/resources · high confidence
Enable layout diffing by default in ComponentTree
Layout diffing is now enabled by default when creating a ComponentTree, improving rendering performance by automatically detecting and applying only the necessary changes to the UI tree rather than re-rendering unchanged components.
src/main · high confidence
Internal annotation processor utilities for testing and lazy evaluation
The Litho annotation processor now includes internal support for a TESTING run mode, allowing it to expose additional public getters for Component props when running in a test environment. To support this and other internal optimizations, the processor introduces a new immutable list implementation, a simple memoizing supplier for lazy computation, and an enum-based RunMode system to thread configuration through the processing pipeline.
litho-processor/src/main/java/com/facebook/litho/specmodels/internal · high confidence
Introduction of Kotlin-based Systracer abstraction
The systrace module now provides a Kotlin interface (Systracer) and a no-op implementation (NoOpSystracer) for tracing, replacing previous inline helpers. This allows applications to instrument code with begin/end section calls and argument logging that automatically become no-ops when tracing is disabled, while also adding a convenience trace extension function for scoped tracing.
systrace · high confidence
Litho 0.51.0 introduces first-draw reporting and updates testing APIs
Version 0.51.0 adds the \useFirstDrawReporter\ hook and \Style.reportFirstContentDraw\ to allow applications to execute actions when a component is fully rendered, which is useful for marking Time to Relevant Content (TTRC) or Time to Interactive (TTI) metrics. This release also includes a breaking change in the testing module: \LegacyLithoViewRule\ has been removed from \com.facebook.litho.testing\, and users must migrate to \LithoTestRule\ and \TestLithoView\. The project also officially switches its license from BSD to Apache-2.0 and updates the minimum SDK version to 24.
(repo-wide) · high confidence
Litho Editor core rewritten in Kotlin with reflection-based editing support
The Litho editor core module has been converted from Java to Kotlin, introducing a new reflection-based architecture for external tools like Flipper to inspect and modify Component fields. This change adds a new \Editor\ interface and an \EditorRegistry\ that maps Java classes to specific editor instances, supporting primitive types, collections, and Litho-specific types like \Style\ and \ColorDrawable\. A new \Reflection\ utility object provides cached, unsafe access to fields and methods, while \SimpleEditor\ enables both mutable and immutable property editing by reading/writing structured \EditorValue\ representations. This allows developers to dynamically update component properties at runtime through external debugging interfaces.
litho-editor-core/src/main/java/com/facebook/litho/editor · high confidence
Litho Editor instances rewritten in Kotlin with expanded type support
The editor instance implementations in the litho-editor-core module have been converted from Java to Kotlin, improving maintainability and interoperability with modern Android development practices. This migration also introduces support for editing additional data types, including atomic variables (AtomicBoolean, AtomicInteger, AtomicReference), collections (List, Map), generic objects, and Android-specific types like android.util.Size and ComparableColorDrawable. Users can now edit these complex types directly within the Litho editor, with proper handling of null values, type conversions, and nested property editing.
litho-editor-core/src/main/java/com/facebook/litho/editor/instances · high confidence
Litho Spec API annotations overhaul and lifecycle expansion
The Litho annotations library has been significantly updated to support new component lifecycle hooks and refined event handling. New annotations include @OnAttached and @OnDetached for resource management during component tree attachment, @OnCalculateCachedValue and @CachedValue for optimized value caching, and @OnBindDynamicValue for applying dynamic prop changes. Event handling is enhanced with @OnTrigger and @FromTrigger for parent-to-child event dispatching, while @EventHandlerRebindMode allows controlling event handler rebinding behavior. The API also introduces @Comparable for fine-grained equivalence checking in isEquivalentTo calls, @ShouldAlwaysRemeasure and @ShouldExcludeFromIncrementalMount for layout optimization control, and @OnError for child component error handling. Several legacy annotations (@FromBind, @FromCreateLayout, @OnLayoutTransition) have been removed, and the @Event annotation now supports a rebind mode parameter. The build configuration has also been migrated to use Skylark/Buck2 definitions with Apache 2.0 licensing.
litho-annotations/src/main/java/com/facebook/litho · high confidence
Litho configuration system migrated to Kotlin with new component equality modes
The Litho configuration module has been converted to Kotlin, consolidating settings into a new \ComponentsConfiguration\ data class and introducing \ComponentEqualityMode\ to allow optimized equality checks for \LayoutSpec\ and spec-generated components. This change also adds new configuration options for pre-allocation handling, primitive recycler binder strategies, and visibility processing, while removing several legacy configuration flags.
litho-core/src/main/java/com/facebook/litho/config · high confidence
Litho documentation website migrated to Docusaurus v2
The Litho documentation site has been rebuilt using Docusaurus v2, replacing the previous static site generator. This migration introduces a modern React-based architecture, enabling features such as MDX support for mixing Markdown with JSX components, a redesigned sidebar navigation, and a new landing page with responsive video embedding. The site now includes a custom \VersionedCodeBlock\ component to automatically inject current library versions into code snippets, and it supports both light and dark themes for code highlighting. Configuration files for Prettier, Babel, and Algolia search have been added to streamline development and improve documentation discoverability.
website · high confidence
Litho sample app restructured with new navigation and debug tooling
The Litho sample application has been reorganized to feature a new hierarchical navigation system driven by Sections, allowing users to browse demos grouped by category (e.g., Playground, Kotlin, Java, Animations) via a \RecyclerCollectionComponent\-based list. The app now supports immersive full-screen mode for specific demos and integrates Flipper plugins (UI Debugger, Inspector, Sections) for runtime debugging. Additionally, a debug event bus has been enabled to track touch events and state changes, and the minimum SDK has been set to 21 with a target of 33.
sample · high confidence
Litho stats module converted to Kotlin
The LithoStats module, which provides global counters for internal Litho performance analysis (such as state updates, layout calculations, and subtree caching metrics), has been rewritten from Java to Kotlin. This change maintains the existing public API and functionality for tracking component and section lifecycle events, ensuring no behavioral change for users relying on these statistics.
litho-core/src/main/java/com/facebook/litho/stats · high confidence
LithoYogaFactory migrated to Kotlin
The LithoYogaFactory implementation has been converted from Java to Kotlin. This change is a language migration with no observable behavioral differences for users; the factory continues to provide Yoga configuration and node creation methods with the same public API.
litho-core/src/main/java/com/facebook/litho/yoga · high confidence
MaterialTextInput component moved to new litho-widget-material module
The MaterialTextInputSpec and its supporting classes (MountableTextInputLayout, MaterialTextInputColorStateList) have been moved into the new litho-widget-material module. This change addresses an app size regression by isolating Material Design-specific input components, ensuring the component remains available for users who need Material-styled text inputs with features like floating labels and specific color state handling.
litho-widget-material · high confidence
Migrate Litho FrescoImage API to Fresco Vito
The Kotlin API for Litho's Fresco image integration has been updated to use Fresco Vito. The new \FrescoVitoImage\ builder function now creates \FrescoVitoImage2\ components, requiring callers to pass \ImageSource\ and \ImageOptions\ from the Fresco Vito library instead of the previous Fresco 1.x types.
litho-fresco-kotlin · high confidence
Migrate Litho barebones sample to Kotlin
The sample-barebones application has been rewritten from Java to Kotlin. This update replaces the legacy Java components (such as FeedItemSpec and the old SampleActivity) with new Kotlin equivalents (ListItemSpec and a modernized SampleActivity), updates the AndroidManifest to reflect the new package name and metadata, and removes the obsolete BUCK build files in favor of the current build configuration.
sample-barebones · high confidence
Migrate Yoga library to Apache 2.0 license and update build configuration
The Yoga library has switched its license from BSD-style to Apache 2.0. The build system has been updated to use the new \litho\_android\_library\ definition, which explicitly sets the language to JAVA and configures ProGuard rules to preserve the \@com.facebook.yoga.annotations.DoNotStrip\ annotation. Additionally, the build now explicitly depends on the \com.facebook.yoga:proguard-annotations\ library (version 1.14.1) to handle these annotations, replacing previous bundled or implicit definitions.
lib/yoga · high confidence
Migrate litho-core core classes to Kotlin
The core litho-core classes (including AOSPLifecycleOwnerProvider, LithoVisibilityEventsController, AccessibilityRole, AccessibilityUtils, Animations, Attachable, and various binder/attribute classes) have been converted from Java to Kotlin. This change modernizes the codebase, improves null-safety, and reduces boilerplate without altering the public API or runtime behavior for users. Also in this area: 4 commits (2 fixes) modifying litho-core.
litho-core/src/main/java/com/facebook/litho, litho-core/src/main/java/com/facebook/litho/core · medium confidence
Migrate litho-widget to pure Kotlin
The litho-widget module has been converted from Java to Kotlin, making it a pure Kotlin library. This change includes the conversion of core components and utilities such as RecyclerBinder, SectionsRecyclerView, and various layout helpers, along with the migration of configuration classes like ComponentsConfiguration to Kotlin. For users, this modernizes the codebase, improves interoperability with Kotlin-first projects, and may require updating build configurations to support Kotlin compilation.
litho-widget · high confidence
Migrate yogajni build to Apache 2.0 license and Gradle-friendly structure
The yogajni library build configuration has been updated to use the Apache 2.0 license instead of the previous BSD-style license. Additionally, the build system has been refactored to use Skylark macros via \litho\_defs.bzl\, moving the source to a Gradle-friendly location and replacing native C++ library definitions with custom macros to improve compatibility with modern build tools.
lib/yogajni · high confidence
New Kotlin-based ViewStyles implementation for Litho components
The Litho core library introduces a new Kotlin file, ViewStyles.kt, which defines the internal style item structures (ObjectStyleItem, FloatStyleItem, DimenField) and their application logic for View properties. This change consolidates the handling of various view attributes—including click handlers, focus events, touch interception, alpha, rotation, elevation, and system gesture exclusion zones—into a unified, type-safe Kotlin implementation. For users, this represents a foundational shift in how view styles are processed internally, likely improving performance and reducing app size through Kotlin-specific optimizations like inlining, while maintaining compatibility with existing style APIs.
litho-core/src/main/java/com/facebook/litho/view · medium confidence
Refines Binder Style API with explicit View and HostView mount callbacks
The Binder Styles API in litho-core has been restructured to provide clearer separation between generic content binding and view-specific mounting. The previous \onBind\ and \onBindView\ methods have been renamed to \onBindWithDescription\ and \onBindViewWithDescription\ respectively to emphasize the requirement for dependency tracking and debugging names. A new \onBindHostViewWithDescription\ style has been introduced, allowing binders to be applied specifically to a wrapped \HostView\ even if the component renders a standard \View\. Additionally, the older, less explicit overloads of \onBind\ and \onBindView\ that lacked dependency parameters have been deprecated with an error level to enforce safer usage patterns.
litho-core/src/main/java/com/facebook/litho/binders · high confidence
Removal of libfb BUCK build file
The BUCK build configuration file for the libfb library has been removed from the project. This change eliminates the legacy build rules previously used to compile this component, indicating a shift away from the BUCK build system for this specific library.
lib/fb · high confidence
Removal of local BUCK build files for javapoet and commons-cli
The local BUCK build definitions for the javapoet and commons-cli libraries have been removed from the repository. This change eliminates the manual build rules that previously defined these dependencies as prebuilt JARs with specific visibility scopes, indicating a shift in how these libraries are managed or integrated into the build system.
lib/javapoet · high confidence
Removal of local Fresco dependency definitions
The local BUCK build file for the Fresco library has been removed, eliminating the hardcoded definitions for Fresco 1.1.0 artifacts (including fresco, drawee, imagepipeline, and bolts) that were previously fetched via remote\_file targets. This change indicates that the Fresco dependency is no longer managed locally within this specific build configuration, likely shifting to an external or centralized dependency management strategy.
lib/fresco · high confidence
Removal of local M2 repository dependency for fbcore
The local build configuration for the fbcore library has been updated by removing the BUCK file that previously defined the target as a remote file fetched from a local Maven (M2) repository. This change eliminates the manual download and caching of the com.facebook.fresco:fbcore:1.1.0 AAR artifact via a remote\_file rule, simplifying the build dependency management for this component.
lib/fbcore · high confidence
Removed local M2 repository BUCK files
The BUCK build files for the lib/objenesis and lib/sqlite libraries have been removed. This change eliminates the local Maven repository dependency definitions for these modules, aligning with the broader migration of build configurations away from local M2 repo dependencies.
lib/objenesis · high confidence
Removed local M2 repository dependency build files
The BUCK build configuration files for the lib/asm and lib/junit modules have been deleted. This change removes the local Maven repository dependency definitions for these libraries, aligning with the migration of build definitions to Skylark and the adoption of fb\_java\_library targets.
lib/asm, lib/junit · high confidence
Transition extension input and host interfaces converted to Kotlin
The transition extension interfaces and utilities in the RenderCore transitions module have been converted from Java to Kotlin. This includes the \TransitionsExtensionInput\ interface, which provides access to transition data for mount delegates, as well as supporting interfaces like \AnimatedRootHost\ and \DisappearingHost\ for managing animated size updates and disappearing animations, and the \TransitionUtils\ object containing helper methods for applying bounds to drawables and managing transition IDs.
litho-rendercore-transitions/src/main/java/com/facebook/rendercore · high confidence
Update license and build configuration for litho-annotations
The litho-annotations module now uses the Apache 2.0 license instead of the previous BSD-style license. The build configuration has been updated to load definitions from the new Skylark-based DEFS.bzl file and uses the fb\_java\_binary rule instead of the standard java\_binary, aligning with the project's migration to Skylark build rules.
litho-annotations · high confidence
View compatibility components migrated to Kotlin
The \SimpleViewBinder\, \ViewBinder\, and \ViewCreator\ classes in the \litho-core\ view compatibility layer have been converted from Java to Kotlin. This change updates the internal implementation language for these view binding and creation utilities, which may affect how they are extended or implemented in Kotlin-based projects, while maintaining the same public API surface for binding data to views and creating view instances.
litho-core/src/main/java/com/facebook/litho/viewcompat · high confidence
Visibility extension rewritten in Kotlin with new event types and optimization hooks
The visibility extension in \litho-rendercore-visibility\ has been converted from Java to Kotlin, introducing new event classes (\VisibleEvent\, \FocusedVisibleEvent\, \UnfocusedVisibleEvent\, \FullImpressionVisibleEvent\, \InvisibleEvent\, \VisibilityChangedEvent\) and a \VisibilityBoundsTransformer\ interface to allow custom occlusion handling. The update also adds a \CachedVisibleRectProvider\ interface for parent ViewGroups to cache visible rects during batch operations, improving performance for partially-occluded hierarchies, and includes configuration flags in \VisibilityExtensionConfigs\ to enable debug logging and the cached rect optimization.
litho-rendercore-visibility/src/main/java · high confidence
Test coverage
1 commit adding/updating tests in litho-instrumentation-tests; 1 commit adding/updating tests in litho-it/src/test/com/facebook/litho/customlayout; 17 commits adding/updating tests in litho-it/src/test/com/facebook/litho/widget/collection; 2 commits adding/updating tests in litho-compiler-plugin/compiler/src/test/kotlin/com/facebook/litho/autodeps; 2 commits adding/updating tests in litho-coroutines-kotlin/src/test/kotlin/com/facebook/litho/animation; 26 commits adding/updating tests in litho-it/src/test/com/facebook/litho/animation; 3 commits adding/updating tests in litho-it/src/test/com/facebook/litho/zoomable; 4 commits adding/updating tests in litho-compiler-plugin/compiler/src/test/kotlin/com/facebook/litho/analysis; 4 commits adding/updating tests in litho-compiler-plugin/compiler/src/test/kotlin/com/facebook/litho/processor; 45 commits adding/updating tests in litho-it/src/test/com/facebook/litho/widget; 5 commits adding/updating tests in litho-it/src/test/com/facebook/litho/binders; 7 commits adding/updating tests in litho-it/src/test/com/facebook/litho/visibility; 7 commits adding/updating tests in litho-rendercore-primitive-components/canvas/src/test; 8 commits adding/updating tests in litho-compiler-plugin/compiler/src/test/kotlin/com/facebook/litho; 8 commits adding/updating tests in litho-it/src/test/com/facebook/litho/layout; 9 commits adding/updating tests in litho-it/src/test/com/facebook/litho/state; Add processor integration test resources for Litho specs; Added Kotlin test utilities for Litho component testing; Added Litho integration test components for state update scenarios; Added Litho testing components and specs in Kotlin; Added Mockito inline mock maker configuration for integration tests; Added Robolectric configuration for SDK 33; Added compiler diagnostics tests for auto-deps and hook usage; Added comprehensive test coverage for the Incremental Mount extension; Added instrumentation test for TTI marker rendering; Added instrumentation tests for Litho Espresso matchers and text content; Added instrumentation tests for Section tree prop propagation; Added instrumentation tests for TreeProp propagation and RenderCompleteEvents; Added integration test resources for Section processor; Added integration tests for Litho testing utilities; Added integration tests for click listeners, frame rate styles, and view styles; Added test coverage for Litho IntelliJ plugin components; Added test coverage for Litho keyboard traversal, binder migration, device info, debug overlay, layout parity, and touch input handling; Added test data classes for processor validation; Added test fixtures for Litho component and section spec classes; Added test fixtures for Litho error handling and TreeProp propagation; Added test fixtures for Litho inspection annotators; Added test helper section specs in litho-it; Added test helpers for Litho processor spec models; Added test infrastructure for Litho SpecModel validation and generation; Added test infrastructure for state reading and update verification; Added test infrastructure for validating @TestSpec annotations; Added test resources for Litho compiler plugin validation; Added test utilities for Litho instrumentation and screenshot testing; Added test utilities for parsing compiler test files; Added tests for DI-enabled generic Components; Added tests for Flexbox gap integration, mapping, and legacy builder behavior; Added tests for LayoutScope effects in Litho integration tests; Added tests for Litho Editor Flipper prop data extraction; Added tests for Litho animation and DynamicValue styles; Added tests for Litho event triggers; Added tests for Litho spec model generators; Added unit tests for Litho Kotlin Coroutines APIs; Added unit tests for Litho Sections core components; Added unit tests for Litho accessibility, dataflow, and drawable components; Added unit tests for Litho component lifecycle and styling; Added unit tests for Litho utility classes; Added unit tests for LiveData integration in Litho components; Generated matchers for Litho test specs; New Espresso testing utilities for Litho components; New LithoCollectionItem lifecycle and state management tests; New RenderCore testing utilities for view hierarchy assertions; New testing utilities for matching View hierarchies and props; Removed legacy Components test suite; Updated test fixtures for Litho IntelliJ plugin completion.
Dependencies
Add Gradle build configuration for Litho codelabs
Added Gradle build files for the Litho codelabs (events, group-section-lifecycle, hello-world, hscroll-height, layout-spec, mount-spec, props), configuring them to use Litho version 0.26.1, Kotlin 1.3.21, and Android Gradle Plugin 3.3.2/3.4.1. These files establish the necessary dependencies (litho-core, litho-widget, litho-processor, etc.) and build settings to allow developers to run and experiment with the codelab examples.
(dependencies) · high confidence
Upgrade Gradle wrapper to version 8.1
The project's Gradle wrapper has been updated to use Gradle 8.1 (specifically the 'all' distribution). This ensures that builds will now run using the Gradle 8.1 runtime, which may bring changes to build performance, plugin compatibility, and build script syntax requirements compared to previous versions.
gradle · high confidence
Upgrade SoLoader dependencies to v0.10.5 and migrate build definitions
The SoLoader library has been updated to version 0.10.5, including its nativeloader and annotation components, which are now fetched as remote Maven artifacts. The build configuration has been migrated from the legacy \android\_prebuilt\_aar\ rule to the \litho\_android\_library\ definition, and the build system now uses \fb\_prebuilt\_jar\ and \fb\_native\_wrapper\ instead of the older \fb\_native.prebuilt\_jar\ and direct \fb\_native\ calls. Additionally, the license header has been updated to Apache 2.0.
lib/soloader · high confidence
Upgrade infer-annotations to version 0.18.0
The bundled infer-annotations library has been updated from version 4.0 to 0.18.0, fetched remotely via Maven. This upgrade brings new capabilities, including the @Cleanup annotation, and shifts the build definition to use the new fb\_prebuilt\_jar rule and Apache-2.0 license headers.
lib/infer-annotations · high confidence
Housekeeping
Add Litho IntelliJ Plugin documentation and build scripts
The plugin directory now includes a README with installation instructions for both Gradle and BUCK build systems, a comprehensive CHANGELOG detailing version history up to 1.8.6, and shell scripts (buildPlugin.sh and testPlugin.sh) to automate building and testing the plugin.
litho-intellij-plugin · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 61 → 62 (+1.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 82 → 82 (+0.1)
- Architecture 96 → 96 (+0.3)
- Maturity 71 → 77 (+5.6)
- Readiness 47 → 53 (+5.6)
- Security 68 → 57 (-11.1)
- Performance 83 → 100 (+16.6)
Resolved (136)
- CanvasState.configureStrokePaint (cyclomatic 19) (litho-rendercore-primitive-components/canvas/src/main/java/com/facebook/primitive/canvas/CanvasState.kt)
- ClassTooLong: FlexboxLegacyContainerBuilder (litho-core/src/main/java/com/facebook/litho/FlexboxLegacyContainerBuilder.kt)
- CustomLayoutContainerKt.layOutWithin (cognitive 20) (litho-core/src/main/java/com/facebook/litho/CustomLayoutContainer.kt)
- Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
- Duplicate implementation across types. NoCache and SynchronizedItemCache both implement the same methods as ItemCache. NoCache is likely a no-op or pass-through implementation, and SynchronizedItemCache adds synchronization. ItemCache is likely the interface or base class. This is a consistent strategy pattern.
- Duplicate implementation across types. NoOpSystracer is a direct duplicate of Systracer with identical method signatures and likely identical internal logic (no-ops). While this is a common pattern for dependency injection/testing, exposing both as top-level public types with identical APIs can be confusing. However, given the distinct intent (active vs no-op), this is a standard design pattern rather than an inconsistency.
- Duplicate implementation across types. PreparationHealthTracker implements the exact same interface/signatures as PreparationHealthObserver. PreparationHealthTracker appears to be a concrete implementation of the PreparationHealthObserver interface (or abstract class), but both are exposed as public types with identical method sets. This is consistent with an interface/implementation relationship, but the naming *Tracker vs *Observer is slightly ambiguous regarding which is the contract and which is the impl. However, looking at the constructor, PreparationHealthTracker has a constructor, implying it's a class. PreparationHealthObserver has no constructor listed, implying it is an interface. This is consistent.
- Duplicated block (10 lines × 2) (litho-core/src/main/java/com/facebook/litho/BinderMigratedNodeInfo.kt)
- Duplicated block (10 lines × 2) (litho-core/src/main/java/com/facebook/litho/LithoYogaLayoutFunction.kt)
- Duplicated block (10 lines × 2) (litho-widget/src/main/java/com/facebook/litho/widget/RecyclerBinder.kt)
- Duplicated block (10 lines × 2) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/primitives/SimpleImageViewPrimitiveComponent.kt)
- Duplicated block (10 lines × 2) (sample/src/main/java/com/facebook/samples/litho/kotlin/mountandvisibility/ViewPager2IncrementalMountActivity.kt)
- Duplicated block (10–11 lines × 2) (litho-rendercore/src/main/java/com/facebook/rendercore/Dimen.kt)
- Duplicated block (11–12 lines × 2) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/animations/statebased/SpecComparisonComponent.kt)
- Duplicated block (12 lines × 2) (litho-widget/src/main/java/com/facebook/litho/widget/CardClipDrawable.kt)
- Duplicated block (12 lines × 2) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/animations/docs/GlobalKeyNotWorkingComponents.kt)
- Duplicated block (12 lines × 2) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/primitives/widgets/PrimitiveWidgetsExampleComponent.kt)
- Duplicated block (12 lines × 2) (sample/src/main/java/com/facebook/samples/litho/kotlin/mountandvisibility/ViewPager2IncrementalMountActivity.kt)
- Duplicated block (12 lines × 3) (litho-widget/src/main/java/com/facebook/litho/widget/PrimitiveImage.kt)
- Duplicated block (12 lines × 3) (litho-widget/src/main/java/com/facebook/litho/widget/PrimitiveImage.kt)
- …and 116 more
New (502)
- AnimationController.onFrame (cognitive 16) (litho-core/src/main/java/com/facebook/litho/animation/AnimationController.kt)
- AnimationSpecCompositionKt.withCompositionVisibilityThreshold (cognitive 16) (litho-core/src/main/java/com/facebook/litho/animation/AnimationSpecComposition.kt)
- BoxConstraintsKt.resolveBoxConstraints (cognitive 17) (litho-core/src/main/java/com/facebook/litho/layout/BoxConstraints.kt)
- BoxConstraintsKt.resolveRootBox (cognitive 17) (litho-core/src/main/java/com/facebook/litho/layout/BoxConstraints.kt)
- ClassTooLong: LithoSaveableStateRegistry (litho-core/src/main/java/com/facebook/litho/LithoSaveableStateRegistry.kt)
- ClassTooLong: RCRecyclerView (litho-rendercore-simplelist/src/main/java/com/facebook/rendercore/simplelist/RCRecyclerView.java)
- CollectionPreparationManager.computeRange (cognitive 17) (litho-widget/src/main/kotlin/com/facebook/litho/widget/collection/CollectionPreparationManager.kt)
- CommittedEffects.report (cognitive 16) (litho-core/src/main/java/com/facebook/litho/KResolveEffects.kt)
- ComponentTree.backgroundLayoutStateUpdated (cyclomatic 16) (litho-core/src/main/java/com/facebook/litho/ComponentTree.kt)
- ComponentTree.commitLayoutState (cognitive 16) (litho-core/src/main/java/com/facebook/litho/ComponentTree.kt)
- Duplicated block (10 lines × 2) (litho-core/src/main/java/com/facebook/litho/Column.kt)
- Duplicated block (10 lines × 2) (litho-core/src/main/java/com/facebook/litho/LithoYogaLayoutFunction.kt)
- Duplicated block (10 lines × 2) (litho-it/src/main/java/com/facebook/litho/testing/treeprop/TreePropNumberType.kt)
- Duplicated block (10 lines × 2) (litho-rendercore-incremental-mount/src/main/java/com/facebook/rendercore/incrementalmount/IncrementalMountExtension.kt)
- Duplicated block (10 lines × 2) (litho-rendercore/src/main/java/com/facebook/rendercore/RenderUnit.kt)
- Duplicated block (10 lines × 2) (litho-rendercore/src/main/java/com/facebook/rendercore/RenderUnit.kt)
- Duplicated block (10 lines × 2) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/primitives/SimpleImageViewPrimitiveComponent.kt)
- Duplicated block (10 lines × 2) (sample/src/main/java/com/facebook/samples/litho/kotlin/mountandvisibility/ViewPager2IncrementalMountActivity.kt)
- Duplicated block (10 lines × 3) (sample-kotlin/src/main/java/com/facebook/samples/litho/kotlin/animations/diffbased/DiffBoundsReorderComponent.kt)
- Duplicated block (10–11 lines × 2) (litho-rendercore/src/main/java/com/facebook/rendercore/Dimen.kt)
- …and 482 more
Changes since last survey
- 235 commits — 217 feature/other, 18 fixes
By area
- litho-core/src — 71 commits
- litho-it/src — 34 commits
- litho-widget/src — 20 commits
- litho-rendercore/src — 18 commits
- sample-kotlin/src — 10 commits
- litho-compiler-plugin/compiler — 8 commits
- litho-rendercore-primitive-components/canvas — 8 commits
- lib/yoga — 6 commits
- litho-rendercore-text/src — 6 commits
- litho-surface/src — 6 commits
- litho-testing/src — 5 commits
- litho-rendercore-incremental-mount/src — 4 commits
- sample/src — 4 commits
- docs/layout — 3 commits
- litho-navigation/src — 3 commits
- litho-rendercore-simplelist/src — 3 commits
- litho-coroutines-kotlin/src — 2 commits
- litho-editor-core/src — 2 commits
- litho-rendercore-transitions/src — 2 commits
- litho-rendercore-visibility/src — 2 commits
Notable commits
- fix: Fix 211 and suppress 12 HasBetterKotlinAlternativeMethod violations, and re-enable the rule
- fix: Fix MatchFirstChild sizing from a stale collection size
- fix: Fix RecyclerCollectionComponent deprecation message
- fix: Fix AnimatedContent retention
- fix: Fix useComponentCoroutineScope's tree-wide cancel, behind a global flag
- fix: Fix all 64 SuspiciousImport violations and re-enable the rule
- fix: Fix android_crash:java.lang.IndexOutOfBoundsException:com.facebook.rendercore.visibility.VisibilityMountExtension$Companion.processVisibilityOutputsNonInc
- fix: Fix android_memory_leak_messenger_temp:com.facebook.messaging.threadlist.threaditemmenu.bottomsheet.SimpleUserControlBottomSheetDialogFragment:fe020afd92c68a1ee187fc6b51df6c78a6d4aec
- fix: Fix broken KDoc links to EffectHandler.EmptyRunnable
- fix: Fix style keywords reading back as the wrong unit after a non-integer size (#2056)
- fix: Migrate StoryViewerAdsPillComponentTest off the deprecated Image spec and fix yoga-playground samples
- fix: Revert D125724130
- fix: Revert D128609923: Default all Robolectric tests to NATIVE graphics mode
- fix: litho editor-core: strict (1 target, 8 warning fixes)
- fix: litho-core warning fixes: Java rawtypes + redundant cast (no behavior change)
- fix: litho-core warning fixes: Style/subpackage files (no behavior change)
- fix: litho-core warning fixes: framework root A-L (no behavior change)
- fix: 🧪 [IG4A][Reels SU V2] Add lifecycle and auto-scroll regression coverage
- change: A @DepsFrom parameter can keep the @Deps default for an argument it can't read
- change: A Layout lays out its leaves without Yoga, and keeps their last measurements
- …and 215 more
Architecture
- Unchanged — 0 containers · 25 contexts · 46 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
facebook/litho was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit f841a5c53635be7ed9c534e7dd99f001e970d297 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.64+preprod-569132d3dfbe.