Release Notes

Your guide on how to use and make the most out of RTLCSS

Time is Priceless, Caffeine is Not! Buy Me a Coffee ☕
Introduction Why RTLCSS
Install Options Hooks String Map Aliases Control Directives Value Directives CLI
Writing a plugin Control Directive Definition Value Directive Definition Declaration Processor Metadata Object Context Object
ChangeLog

§4.3.0 - 27 Aug. 2024

  • Return an error code when the parsed CSS stdin is invalid. Thanks @lade-odoo

§4.2.0 - 24 Jul. 2024

  • Add support for eight-value hex colors.

§4.1.1 - 18 Sep. 2023

  • Update mirroring transform to safeguard functions inside values.
  • Internal code refactoring. Thanks @XhmikosR

§4.1.0 - 11 Apr. 2023

  • Update dependencies. Thanks @XhmikosR
  • Update mirroring transform-origin to not flip y-offset when x-offset is center. Thanks @skmanohar
  • Return an error code when the parsed CSS file is invalid. Thanks @HANNICHE-Walid

§4.0.0 - 09 Aug. 2022

  • Update dependencies, Internal code refactoring, cleanup and optimizations. Thanks @XhmikosR
  • Support flipping justify-content, justify-items and justify-self. Thanks @mbehzad
  • Support flipping length position without using calc.

§3.5.0 - 02 Nov. 2021

  • Update dependencies. Thanks @XhmikosR
  • Internal code cleanup/formatting. Thanks @XhmikosR

§3.4.0 - 18 Oct. 2021

  • Support flipping object-position.
  • Update devDependencies.

§3.3.0 - 08 Jul. 2021

  • Add processEnv option to support flipping agent-defined environment variables (safe-area-inset-left, safe-area-inset-right).

§3.2.1 - 22 Jun. 2021

§3.2.0 - 23 May. 2021

  • Add aliases option to support processing Custom Properties (CSS Variables). Thanks @elchininet

§3.1.2 - 04 Feb. 2021

  • Update README.md.

§3.1.1 - 02 Feb. 2021

  • Fixes TypeError when placing value directive before !important. #218

§3.1.0 - 30 Jan. 2021

  • Use strict mode across all files. Thanks @XhmikosR
  • Decrease package size by around 6%. Thanks @XhmikosR
  • Add guards against prototype pollution. Thanks @XhmikosR
  • Allow value directives to be placed any where inside the declaration value.
  • Handle value directives placed after !important.
  • Fix reading config file sources (#209).

§3.0.0 - 10 Dec. 2020

  • Upgrade to postcss 8.
  • Dropped Node.js 6.x, 8.x, 11.x, and 13.x versions.

§2.6.2 - 01 Dec. 2020

  • Set input source to same file in raw directive (#180).

§2.6.1 - 15 Oct. 2020

  • Remove colors dependency from findup (#177).

§2.6.0 - 15 Aug. 2020

  • Support flipping perspective-origin (#167).
  • CLI: Fix empty output when --silent and --stdin flags are used together (Fixes #169).
  • Enable flipping rotateY.
  • Fix flipping rotate3d.

§2.5.0 - 08 Feb. 2020

  • useCalc to flip unit based transform-origin.
  • CLI: use console.log instead of the deprecated util.print(issue #156).

§2.4.1 - 28 Nov. 2019

  • Ignore white spaces before directives prefix.

§2.4.0 - 20 Jun. 2018

  • New Option:
    • useCalc (default: false) to flip unit based background-position using calc. Thanks @zoreet

§2.3.0 - 9 Jun. 2018

  • Skip processing CSS variables. Thanks @danfooo

§2.2.1 - 9 Nov. 2017

  • Fixes a bug in flipping background-position having keywords only (Fixes #107).

§2.2.0 - 7 Jun. 2017

  • Support for pre/post hooks.
  • Upgrade to postcss v6.x

§2.1.2 - 31 Dec. 2016

  • Internal code update.

§2.1.1 - 28 Dec. 2016

  • Fixes a bug in self-closing ignore directive (Fixes #88).

§2.1.0 - 30 Nov. 2016

  • Support CSS background-position edge offsets.

§2.0.7 - 16 Nov. 2016

  • Fixes a bug in flipping backgrounds having URL placed first (Fixes #84).
  • Update node.value so changes will be picked up by other processors (Closes #85).

§2.0.6 - 12 Jul. 2016

  • README updates.

§2.0.5 - 17 May. 2016

  • Fixes a bug in complementing calc values (Fixes #71).

§2.0.4 - 25 Apr. 2016

  • Fixes a bug in flipping cursor value (Fixes #68).

§2.0.3 - 23 Mar. 2016

§2.0.2 - 05 Mar. 2016

  • Fixes a bug in flipping background with a hex color value (Fixes #60).

§2.0.1 - 23 Feb. 2016

  • Fixes a bug when having decl nodes inside atrules and autoRename enabled.
  • Fixes a bug in flipping multi-valued transforms.

§2.0.0 - 18 Feb. 2016

  • Support for control directive blocks, e.g. /*rtl:begin:ignore*/ ... /*rtl:end:ignore*/.
  • Support for strict auto renaming, which ensures autoRename is applied only when a pair exists.
  • New directives:
    • config
    • options
    • raw
    • remove
  • Support for Plugins.

§Upgrading from version 1.0

Options and config settings have changed. However, you need not to worry about your CSS files as all directives are backward-compatible. This is a summary of what’s changed:

  • New Options:

    • autoRenameStrict (default: false) to apply auto rename only when a pair exists.
    • blacklist to prevent execution of certain directives.
    • clean (default: true), to remove directives from output CSS.
    • processUrls (default: false) to control URL updates. You can also target specific node types using an object literal. e.g. {'atrule': true, 'decl': false}.

  • Updated Options:

    • autoRename new default is false.
    • stringMap:
      • added priority attribute to control maps execution order.
      • added exclusive attribute, which determines if a map execution should stop iterating over other maps.
      • dropped 'west-east' map from the default map collection.

  • Removed Options:

    • enableLogging, still warnings and errors are reported directly to postcss.
    • minify, it wasn’t actual minification after all!
    • swapLeftRightInUrl, swapLtrRtlInUrl and swapWestEastInUrl in favor of processUrls option.
    • preserveComments, comments inside declaration values will always be preserved.
    • preserveDirectives, in favor of clean option.

  • Constructor arguments rules, declarations and properties are now replaced with plugins.

§v1.7.4 - 23 Feb. 2016

  • Fixes a bug in flipping multiple transforms.

§v1.7.3 - 30 Jan. 2016

  • Fixes a bug in flipping N-Values containing comments.

§1.7.2 - 30 Jan. 2016

  • Fixes a bug in flipping N-Values containing comments.

§1.7.2 - 04 Dec. 2015

  • Fixes a compatibility issue with postcss-js (Fixes #48).

§1.7.1 - 10 Nov. 2015

  • Fixed a bug in flipping backgrounds having functions (Issue #45).

§1.7.0 - 19 Sep. 2015

  • Add calc support.
  • Mark rule as flipped when values are updated by decl. directives.
  • Allow further processing for rules that uses rename directive.

§1.6.3 - 28 Aug. 2015

  • CLI: fix source map option (issue #40).
  • Upgrade to postcss v5.0.x

§1.6.2 - 21 Jul. 2015

  • CLI: fix loading custom configuration file manually via the --config flag. Thanks @KeyKaKiTO

§1.6.1 - 17 Mar. 2015

  • Fixed flipping units having more than 1 digit before the decimal point.

§1.6.0 - 15 Mar. 2015

  • Support flipping matrix3d transform.

§1.5.2 - 28 Feb. 2015

  • Fix flipping string maps containing regular expressions special characters (Fixes #24).

§1.5.1 - 14 Feb. 2015

  • Fix flipping multiple shadows when a hex color was used. Thanks @ocean90

§1.5.0 - 30 Jan. 2015

  • CLI: New option -e,--ext to set output files extension when processing a directory.

§1.4.3 - 24 Jan. 2015

  • Upgrade to postcss v4.0.x Thanks @necolas

§1.4.2 - 24 Oct. 2014

  • CLI: Switch to Unix line endings (Fixes #14)

§1.4.1 - 24 Oct. 2014

  • CLI: Print processing errors.

§1.4.0 - 10 Oct. 2014

§1.3.1 - 29 Sep. 2014

§1.3.0 - 28 Sep. 2014

  • New feature - String Maps. Add your own set of swappable strings, for example (prev/next).
  • Preserves lowercase, UPPERCASE and Capitalization when swapping left, right, ltr, rtl, west and east.

§1.2.0 - 26 Sep. 2014

  • Support !important comments for directives (enables flipping minified stylesheets).

§1.1.0 - 26 Sep. 2014

  • Upgrade to postcss v2.2.5
  • Support flipping border-color, border-style and background-position-x

§1.0.0 - 24 Aug. 2014

  • Upgrade to postcss v2.2.1
  • Support flipping urls in @import rule.
  • Fix JSON parse error when configuration file is UTF-8 encoded.
  • Better minification.

§0.9.0 - 10 Aug. 2014

  • New configuration loader.
  • CLI configuration can be set using one of the following methods:
    • Specify the configuration file manually via the --config flag.
    • Put your config into your projects package.json file under the rtlcssConfig property
    • Use a special file .rtlcssrc or .rtlcssrc.json

§0.8.0 - 8 Aug. 2014

  • Fix source map generation.

§0.7.0 - 4 Jul. 2014

  • Fix flipping linear-gradient.

§0.6.0 - 4 Jul. 2014

  • Allow additional comments inside ignore/rename rule level directives.

§0.5.0 - 11 Jun. 2014

  • Add CLI support.

§0.4.0 - 5 Apr. 2014

  • Fix flipping transform-origin.
  • Update autoRename to search for all swappable words.

§0.3.0 - 5 Apr. 2014

  • Support flipping rotateZ.
  • Fix flipping rotate3d.
  • Fix flipping skew, skewX and skewY.
  • Fix flipping cursor value.
  • Fix flipping translate3d.
  • Update flipping background horizontal position to treat 0 as 0%

§0.2.1 - 20 Mar. 2014

§0.2.0 - 20 Mar. 2014

  • Support combining with other processors.
  • Support rad, grad & turn angle units when flipping linear-gradient
  • Fix typo in config.js

§0.1.3 - 7 Mar. 2014

  • Fix missing include in rules.js

§0.1.2 - 5 Mar. 2014

  • New option: minify output CSS.
  • Updated README.md

§0.1.1 - 4 Mar. 2014

  • Initial commit.
PREV
Report an issue | View on GitHub | Follow Me on GitHub and Twitter
Created by Mohammad Younes
www.isResponsive.com
AlertifyJS
www.alertifyjs.com