DaddyFrosty/yoga
1
0
Fork 0
Code Issues 96 Pull Requests 31 Actions Packages Projects Releases 33 Wiki Activity

33 Releases 59 Tags

RSS Feed
  • v3.2.1 042f501315
    Compare

    Yoga 3.2.1 Stable

    NickGerleman released this 2024-12-12 17:41:47 -08:00 | 50 commits to main since this release

    Android

    1. Adds support for devices with 16KB page size
    Downloads
  • v3.2.0 f55265f518
    Compare

    Yoga 3.2.0 Stable

    NickGerleman released this 2024-12-02 12:33:53 -08:00 | 52 commits to main since this release

    Yoga 3.2 is a new minor version of Yoga, used by React Native 0.77.

    Highlights

    1. Support for box-sizing
    2. Support for display: contents
    3. Bug fixes and improvements

    Learn more at https://www.yogalayout.dev/blog/announcing-yoga-3.2

    Downloads
  • v3.1.0 69b8934429
    Compare

    Yoga 3.1.0 Stable

    NickGerleman released this 2024-06-22 22:12:23 -07:00 | 102 commits to main since this release

    Yoga 3.1 is a new minor version of Yoga, used by React Native 0.75.

    Highlights

    1. Percentage support for gap properties
    2. Layout conformance and regression fixes
    3. Additional JavaScript bindings

    Learn more at https://www.yogalayout.dev/blog/announcing-yoga-3.1

    Downloads
  • v3.0.4 1b9b878b9a
    Compare

    Yoga 3.0.4 Stable

    NickGerleman released this 2024-04-17 00:02:16 -07:00 | 145 commits to main since this release

    JavaScript

    1. Changes NPM packaging to workaround TypeScript resolution issues
    Downloads
  • v3.0.3 ed5d2ffc2d
    Compare

    Yoga 3.0.3 Stable

    NickGerleman released this 2024-04-09 16:13:40 -07:00 | 148 commits to main since this release

    JavaScript

    1. Add entrypoint for usage without top-level await
    2. Expose bindings for hasNewLayout()
    Downloads
  • v3.0.2 397d304e14
    Compare

    Yoga 3.0.0 Stable

    NickGerleman released this 2024-03-12 22:19:15 -07:00 | 152 commits to main since this release

    Yoga 3.0 is a new major (breaking) version of Yoga, used by React Native 0.74.

    Highlights

    1. Support for position: static
    2. Support for align-content: space-evenly
    3. Improvements to layout correctness
    4. Yoga’s JavaScript bindings are now distributed as an ES Module
    5. Fixes several crashes in Java bindings
    6. Some existing Yoga APIs have been removed

    Learn more at https://yogalayout.dev/blog/announcing-yoga-3.0

    Downloads
  • v2.0.1 3a96c7717d
    Compare

    Yoga 2.0.1 Stable

    NickGerleman released this 2023-10-31 21:49:09 -07:00 | 389 commits to main since this release

    JavaScript

    1. Fixesyoga-layout/wasm-sync exporting an async entrypoint if browser or node export conditions not met
    Downloads
  • v2.0.0 83a58bb9d6
    Compare

    Yoga 2.0.0 Stable

    NickGerleman released this 2023-07-26 22:28:21 -07:00 | 391 commits to main since this release

    We are excited to announce a new major (breaking) version of Yoga. This release contains 198 new commits from 64 contributors, and includes the first significant changes to Yoga in open-source since 2018.

    While there has been a long gap in development, the React Native team believes Yoga is a critical tool in delivering the future of React, and we have resumed development of the engine. This release of Yoga is focused on:

    1. Delivering the features we have shipped to React Native to standalone Yoga users
    2. Updating toolchains, packaging, and build systems to make Yoga easier to consume
    3. API changes to allow us to evolve the engine towards conformance

    Yoga continuously ships to thousands of surfaces across multiple frameworks at Meta. This version of Yoga corresponds to the version which will be included in React Native 0.73 shipping this fall.

    Flexbox gap

    The most significant new feature for users on an older stable release of Yoga is the addition of Flexbox gap support. This powers gap, rowGap, and columnGap in React Native 0.71.

    // Example.cpp
YGNodeStyleSetGap(node, YGGutterRow, 2.0f);

    // Example.java
node.setGap(YogaGutter.ROW, 2.0f);

    // Example.ts
node.setGap(Gutter.Row, 2);

    Toolchain

    Meta uses Buck across its monorepo, but we recognize that Buck has acted as a barrier to be able to use Yoga outside of Meta. Yoga no longer ships build logic for Buck to open-source. We have instead added over 20 new validation jobs to GitHub Actions to continually validate that Yoga builds correctly in common systems and scenarios where Yoga is used in OSS.

    New toolchain support includes:

    1. A reference CMake build for Yoga and its unit tests
    2. A modern Gradle build and published AARs
    3. Compatibility with XCode 14.3+
    4. Compatibility with Node 16+
    5. Support for WebAssembly in both Node and browsers
    6. Support for MSVC, higher warning levels, and building without exceptions

    Aiming for Conformance

    Our team wants to enable engineers to be able to create a single style which renders faithfully across Yoga and web. Conformance is a moving target, with browsers like Chromium regularly making behavior changes to better achieve it. This requires making behavior changes to Yoga which break existing behaviors, for better consistency with the web.

    In Yoga 2.0, we’ve generalized UseLegacyStretchBehaviour to a new Errata API, to allow different parts of a Yoga tree to target different conformance levels. This allows rendering part of the tree to be compatible with styles written for web, with other parts compatible with styles written for older versions of Yoga.

    Yoga's default behavior going forward is W3C compliance. We recommend users sensitive to the change to set YGErrataClassic, or YGErrataAll if you were already setting UseLegacyStretchBehaviour.

    // Example.cpp
YGConfigRef config = YGConfigNew();
YGConfigSetErrata(config, YGErrataClassic);

YGNodeRef node = YGNodeNewWithConfig(config);

    // Example.java
YogaConfig config = YogaConfigFactory.create();
config.setErrata(YogaErrata.CLASSIC);

YogaNode node = YogaNodeFactory.create(config);

    // Example.ts
const config = Config.create();
config.setErrata(Errata.Classic);

const node = Node.create(config);

    Yoga for JavaScript

    Yoga’s previous JavaScript bindings are not installable when using Node 12+, making them effectively unusable in today’s JavaScript ecosystem. We now ship a new package with prebuilt binaries and first-class support for TypeScript and modern bundlers.

    Two variants are shipped:

    1. An asmjs variant for compatibility
    2. A JS module with embedded WebAssembly (~50% faster)

    Both are about 45KB when gzipped.

    WebAssembly binaries must be asynchronously compiled and loaded in Chrome. In the absence of universal support for top-level await, we have made the breaking change to require explicitly asynchronously loading Yoga before using it.

    import {loadYoga, Align} from 'yoga-layout';

const Yoga = await loadYoga();
const node = Yoga.Node.create();
node.setAlignContent(Align.Center);

    The previous behavior of blocking to load the binary can be replicated by importing from the yoga-layout/sync entrypoint, but this is not recommended for new usages, and does not allow using WebAssembly on browsers.

    import Yoga, {ALIGN_CENTER} from 'yoga-layout/sync';

const node = Yoga.Node.create();
node.setAlignContent(ALIGN_CENTER);

    yoga-layout and yoga-layout/sync try to pick between asmjs and WebAssembly automatically based on the target environment set by your bundler, but you can choose this explicitly as well.

    import {loadYoga} from 'yoga-layout/wasm-async';

    Note: the yoga-layout package requires your bundler and typechecker to configured to be able to follow the package exports field.

    Deprecations and removals

    YogaKit and YogaLayout ViewGroup

    We are deprecating, YogaKit and the YogaLayout ViewGroup. These libraries allow initegrating Yoga directly with UIKit and the Android view system, but are not widely used by Meta in production. We are instead focusing on higher-level libraries using Yoga like Litho and React Native. Because we aren’t in a place to continue development, or validate contributions, we are discontinuing development. These libraries will not receive future updates beyond the Yoga release-v2.0 branch.

    UseLegacyStretchBehaviour

    The functions to manipulate UseLegacyStretchBehaviour have been deprecated. Previous users of the API should now set an appropriate errata level, like YGErrataAll to opt-out of all future conformance fixes.

    C# bindings

    C# bindings were contributed to the Yoga repo but have since degraded. The bindings have not had working build validation, or a consistent contributor. We have removed them from the Yoga repo, but we will continue to provide a public C ABI for others to build bindings on top of.

    Private C++ APIs

    Yoga’s header structure has historically allowed the inclusion of concrete internal structures like YGStyle or YGNode. We will begin to enforce that users instead rely on the public C APIs provided by #include <yoga/Yoga.h>. Other C++ APIs may change without notice.

    // Public API (GOOD)
#include <yoga/Yoga.h>

YGConfigRef config = YGConfigNew();
YGConfigSetPointScaleFactor(config, 1.0f);

    // Private API (BAD)
#include <yoga/YGConfig.h>

YGConfig config{yogaLogger_};
config.pointScaleFactor = 1.0f;

    C++ 11 Support

    Yoga now requires a compiler which supports C++ 14. This will likely be bumped to C++ 17 in a future minor release.

    How do I get it?

    For users who don’t want to build from source, new Yoga packages have been published to the npmjs registry, Maven Central, and CocoaPods.

    // package.json
dependencies: {
  "yoga-layout": "^2.0.0"
}

    // build.gradle
dependencies {
  implementation("com.facebook.yoga:yoga:2.0.0")
}

    # Podfile
pod 'Yoga', '~> 2.0.0'

    Acknowledgements

    Yoga 2.0 contains major external contributions from @intergalacticspacehighway, @jacobp100, @jeetiss and @nicoburns.

    Downloads
  • v1.19.0 8a65d8b6dc
    Compare

    v1.19.0 Stable

    passy released this 2021-05-21 11:41:13 -07:00 | 598 commits to main since this release

    Release for Maven Central.

    Downloads
  • 1.18.0 0be0e9fc01
    Compare

    v1.18.0 Stable

    priteshrnandgaonkar released this 2019-11-08 04:03:00 -08:00 | 689 commits to main since this release

    Downloads