[4.0.0] - 2025-08-03

Added

• Added leftFlipperAriaLabel and rightFlipperAriaLabel for customizing the aria-label attribute for flipper buttons, by @compulim, in PR #98
• Added stylesRoot property which allows to specify a container node component styles will be placed into, by @OEvgeny in PR #102

Changed

• Avoided global pollution via @babel/runtime-corejs3, by @compulim, in PR #99
• Bundle is now built using Webpack for compatibility with IE Mode, by @compulim, in PR #99
• Bump dependencies, by @compulim, in PR #99, and PR #103
  • Added bump scripts
  • Bumped scaffold
  • Production dependencies
    • @emotion/css@11.13.5
    • classnames@2.5.1
    • html-react-parser@5.2.6
  • Development dependencies
    • @babel/preset-env@7.28.0
    • @babel/preset-react@7.27.1
    • @babel/preset-typescript@7.27.1
    • @emotion/css@11.13.5
    • @testing-library/dom@10.4.1
    • @testing-library/react@16.3.0
    • classnames@2.5.1
    • esbuild@0.25.8
    • eslint-import-resolver-node@0.3.9
    • eslint-import-resolver-typescript@4.4.4
    • eslint-plugin-import@2.32.0
    • eslint-plugin-prettier@5.5.3
    • eslint-plugin-react@7.37.5
    • eslint@9.32.0
    • jest@30.0.5
    • prettier@3.6.2
    • publint@0.3.12
    • react-dom@18.3.1
    • react-test-renderer@18.3.1
    • react@18.3.1
• 💥 Default has been renamed to ReactFilm, by @compulim, in PR #103
• retrofit() is now available in CJS, ESM and UMD, by @compulim, in PR #103

Changes

• Added support of GitHub Codespaces, by @compulim, in PR #89
• Changed peer dependencies requirement to react >= 16.8.6, by @compulim, in PR #89
• Bump dependencies, by @compulim, in PR #89
  • Development dependencies
    • @babel/cli@7.15.7
    • @babel/core@7.15.8
    • @babel/plugin-transform-runtime@7.15.8
    • @babel/preset-env@7.15.8
    • @babel/preset-react@7.14.5
    • @testing-library/jest-dom@5.14.1
    • @testing-library/react@12.1.2
    • @testing-library/user-event@13.3.0
    • concurrently@6.3.0
    • core-js@3.18.3
    • esbuild@0.13.6
    • eslint-plugin-prettier@4.0.0
    • eslint-plugin-react@7.26.1
    • eslint@7.32.0
    • husky@7.0.2
    • jest@27.2.5
    • prettier@2.4.1
    • react-scripts@4.0.3
    • serve@12.0.1
    • web-vitals@2.1.2

Fixed

• Fixed #75. Flippers, dots, and scroll bar should work in right-to-left (RTL) correctly in Chrome 85 and beyond, by @compulim, in PR #86

Changes

• Moved from webpack to esbuild@0.12.1, by @compulim, in PR #85
• Bump dependencies, by @compulim, in PR #85
  • Production dependencies
    • @babel/runtime-corejs3@7.14.0 from @babel/runtime
    • @emotion/css@11.1.3 from create-emotion
    • classnames@2.3.1
    • core-js@3.12.1
    • html-react-parser@1.2.6
    • memoize-one@5.2.1
  • Development dependencies
    • @babel/cli@7.14.3
    • @babel/core@7.14.3
    • @babel/plugin-transform-runtime@7.14.3
    • @babel/preset-env@7.14.2
    • @babel/preset-react@7.13.13
    • concurrently@6.1.0
    • eslint-plugin-prettier@3.4.0
    • eslint-plugin-react-hooks@4.2.0
    • eslint-plugin-react@7.23.2
    • eslint@7.26.0
    • jest@26.6.3
    • lerna@4.0.0
    • prettier@2.3.0

Breaking changes

• API through React Context is being deprecated in favor of React Hooks
• CSS has been revamped by introducing support of customization through CSS BEM
  • className props are removed from sub-components
  • createBasicStyleSet() will only return a single complete style set, namely root. The style set will be a React CSS object, instead of a class name
  • styleSet prop will accept a map of React CSS object, instead of class names

Added

• Revamped in PR #57, #58, #59, #60, #61 and #62
  • Single set of CSS BEM style
  • Added nonce prop for Content Security Policy support
  • Added React Hooks API
  • Added RTL support on Chromium Edge
  • Added overscroll-behavior-x: contain to prevent scroll-chaining
  • Added eslint and prettier
  • Sub-component FilmStrip is renamed to Filmstrip
  • Moved from class components to functional components

Changes

• Moved from glamor to create-emotion, in PR #57
• Replaced babel-plugin-version-transform with babel-plugin-transform-inline-environment-variables, in PR #56
• Bump dependencies, in PR #56
  • Production dependencies
    • @babel/runtime@7.11.2
    • classnames@2.2.6
    • create-emotion@10.0.27
    • html-react-parser@0.13.0
    • memoize-one@5.1.1
  • Development dependencies
    • @babel/cli@7.10.5
    • @babel/core@7.11.4
    • @babel/plugin-proposal-object-rest-spread@7.11.0
    • @babel/plugin-transform-runtime@7.11.0
    • @babel/preset-env@7.11.0
    • @babel/preset-react@7.10.4
    • babel-jest@26.3.0
    • concurrently@5.3.0
    • core-js@3.6.5
    • create-emotion@10.0.27
    • eslint-plugin-prettier@3.1.4
    • eslint@7.7.0
    • jest@26.4.2
    • lerna@3.22.1
    • prettier@2.0.5
    • react-app-polyfill@1.0.6
    • react-film@0.0.0-0
    • react-scripts@3.4.3
    • rimraf@3.0.2
    • serve@11.3.2
    • webpack-cli@3.3.12
    • webpack@4.44.1

Changelog

Breaking changes

• z-index added to flipper and filmstrip
  • List item with position: relative will no longer obstructing the left flipper, we are adding z-index: 1 to both flippers, and z-index: 0 to filmstrip to form a new stacking context.

Fixed

• Fixed list item with position: relative will no longer obstructing the left flipper, in PR #XX.
• Fixed unhandled exception for offsetWidth of undefined exception, in PR #XX.

Changelog

Fixed

• Fixed #37, hiding overflowing button when at edge, by @compulim in PR #39.

Changelog

Fixed

• Fixed #37, hiding overflowing button when at edge, by @compulim in PR #38.

Changelog

Breaking changes

• We will no longer include react and react-dom in our NPM package, instead, we will requires peer dependencies of react@^16.8.6 and react-dom@^16.8.6

Added

• Support right-to-left, by @spyip in PR #32.
• Added flipperBlurFocusOnClick prop to BasicFilm and blurFocusOnClick prop to Flipper components, by @tdurnford in PR #33.
• Support right-to-left on IE11, by @spyip in PR #34.
• Hide flipper on edge items and added autoHideFlipperOnEdge option, by @spyip in PR #34.

Changed

• Bump peer dependency, in PR #33
  • react@^16.8.6

Fixed

• Fix server-side rendering, by @giulianok in PR #29.

Changelog

Added

• Support specifying item elements and scrollable container element, by @compulim in PR #21.
• Fix #22. Added style options to hide "cursor: pointer" style, by @compulim in PR #25.

Changed

• For performance reason, deep-customizing component will now need to pass numItems prop to <Composer>, by @compulim in PR #21.
• Bump dependencies, in PR #27
  • @babel/cli@^7.5.5
  • @babel/core@^7.5.5
  • @babel/plugin-proposal-object-rest-spread@^7.5.5
  • @babel/plugin-transform-runtime@^7.5.5
  • @babel/preset-env@^7.5.5
  • @babel/runtime@^7.5.5
  • babel-core@^6.26.3
  • babel-jest@^24.8.0
  • concurrently@^4.1.1
  • jest@^24.8.0
  • react-scripts@^3.0.1
  • rimraf@^2.6.3
  • serve@^11.1.0
  • webpack-cli@^3.3.6
  • webpack@^4.36.1

Fixed

• Fix #23. Fix IE11 not working with CoreJS-polyfilled [...document.children], by @compulim in PR #24.

Changelog

Added

• Support existing web site without React loaded.
  • Load bundle from unpkg.com, then call window.ReactFilm.retrofit(element, props).
  • Retrofit existing DOM tree with a new DOM tree backed by React/ReactDOM in the bundle.

Fixed

• Fix #13. Fix flipper not working on content with <ul>, by @compulim in PR #15.
• Fix #18. Fix flipper should not submit if carousel is a descendant of <form>, by @compulim in PR #19.

Changed

• Fix #12. Split Context into public and internal, by @compulim in PR #16.