Cập nhật

See CHANGE LOG for details.

See CHANGE LOG for details.

See CHANGE LOG for details.

Excalidraw API

Fixes

• onPaste prop should return false to prevent the native excalidraw paste action #3974.

  BREAKING CHANGE

  • Earlier the paste action was prevented when the prop onPaste returned true, but now it should return false to prevent the paste action. This was done to make it semantically more correct and intuitive.

Build

• Enable jsx transform in webpack #4049

Docs

• Correct exportToBackend in README to onExportToBackend #3952

Excalidraw Library

This section lists the updates made to the excalidraw library and will not affect the integration.

Features

• Improve freedraw shape #3984

• Make color ARIA labels better #3871

• Add origin trial tokens #3853

• Re-order zoom buttons #3837

• Add undo/redo buttons & tweak footer #3832

• Resave to png/svg with metadata if you loaded your scene from a png/svg file #3645

Fixes

• Abstract and fix legacy fs #4032

• Context menu positioning #4025

• Added alert for bad encryption key #3998

• OnPaste should return false to prevent paste action #3974

• Help-icon now visible on Safari #3939

• Permanent zoom mode #3931

• Undo/redo buttons gap in Safari #3836

• Prevent gradual canvas misalignment #3833

• Color picker shortcuts not working when elements selected #3817

See CHANGE LOG for details.

See CHANGE LOG for details.

Excalidraw API

Features

• restore(data, localAppState, localElements) and restoreElements(elements, localElements) now take localElements argument which will be used to ensure existing elements' versions are used and incremented. This fixes an issue where importing the same file would resolve to elements with older versions, potentially causing issues when reconciling #3797.

  BREAKING CHANGE

  • localElements argument is mandatory (can be null/undefined) if using TypeScript.

• Support appState.exportEmbedScene attribute in exportToSvg which allows to embed the scene data #3777.

  BREAKING CHANGE

  • The attribute metadata is now removed as metadata was only used to embed scene data which is now supported with the appState.exportEmbedScene attribute.
  • exportToSvg now resolves to a promise which resolves to svg of the exported drawing.

• Expose loadLibraryFromBlob, loadFromBlob, and getFreeDrawSvgPath #3764.

• Expose FONT_FAMILY so that consumer can use when passing initialData.appState.currentItemFontFamily #3710.

• Added prop autoFocus to focus the excalidraw component on page load when enabled, defaults to false #3691.

  Note: Earlier Excalidraw component was focussed by default on page load, you need to enable autoFocus prop to retain the same behaviour.

• Added prop UIOptions.canvasActions.export.renderCustomUI to support Custom UI rendering inside export dialog #3666.

• Added prop UIOptions.canvasActions.saveAsImage to show/hide the Save as image button in the canvas actions. Defauls to true hence the Save as Image button is rendered #3662.

• Export dialog can be customised with UiOptions.canvasActions.export #3658.

  Also, UIOptions is now memoized to avoid unnecessary rerenders.

  BREAKING CHANGE

  • UIOptions.canvasActions.saveAsScene is now renamed to UiOptions.canvasActions.export.saveFileToDisk. Defaults to true hence the save file to disk button is rendered inside the export dialog.
  • exportToBackend is now renamed to UIOptions.canvasActions.export.exportToBackend. If this prop is not passed, the shareable-link button will not be rendered, same as before.

Fixes

• Use excalidraw Id in elements so every element has unique id #3696.

Refactor

• BREAKING CHANGE

  • Rename UIOptions.canvasActions.saveScene to UIOptions.canvasActions.saveToActiveFile#3657.
  • Removed shouldAddWatermark: boolean attribute from options for export APIs #3639.
  • Removed appState.shouldAddWatermark so in case you were passing shouldAddWatermark in initialData.AppState it will not work anymore.

Excalidraw Library

This section lists the updates made to the excalidraw library and will not affect the integration.

Features

• Switch to selection tool on library item insert #3773

• Show active file name when saving to current file #3733

• Add hint around text editing #3708

• Change library icon to be more clear #3583

• Pass current theme when installing libraries #3701

• Update virgil font #3692

• Support exporting json to excalidraw plus #3678

• Save exportScale in AppState #3580

• Add shortcuts for stroke and background color picker #3318

• Exporting redesign #3613

• Auto-position tooltip and suport overflowing container #3631

• Auto release @excalidraw/excalidraw-next on every change #3614

• Allow inner-drag-selecting with cmd/ctrl #3603

Fixes

• view mode cursor adjustments #3809.

• Pass next release to updatePackageVersion & replace ## unreleased with new version #3806

• Include deleted elements when passing to restore #3802

• Import React before using jsx #3804

• Ensure s and g shortcuts work on no selection #3800

• Keep binding for attached arrows after changing text #3754

• Deselect elements on viewMode toggle #3741

• Allow pointer events for disable zen mode button #3743

• Use rgba instead of shorthand alpha #3688

• Color pickers not opening on mobile #3676

• On contextMenu, use selected element regardless of z-index #3668

• SelectedGroupIds not being stored in history #3630

• Overscroll on touch devices #3663

• Small UI issues around image export dialog #3642

• Normalize linear element points on restore #3633

• Disable pointer-events on footer-center container #3629

Refactor

• Delete React SyntheticEvent persist #3700

• Code clean up #3681

Performance

• Improve arrow head sizing #3480

Build

• Add release script to update relevant files and commit for next release #3805

• Add script to update changelog before a stable release #3784

• Add script to update readme before stable release #3781

See CHANGE LOG for details.

ripgrep 13 is a new major version release of ripgrep that primarily contains
bug fixes, some performance improvements and a few minor breaking changes.
There is also a fix for a security vulnerability on Windows
(CVE-2021-3013).

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches the current directory for a regex pattern. By
default, ripgrep will respect gitignore rules and automatically skip hidden
files/directories and binary files.

Some highlights:

A new short flag, -., has been added. It is an alias for the --hidden flag,
which instructs ripgrep to search hidden files and directories.

ripgrep is now using a new
vectorized implementation of memmem,
which accelerates many common searches. If you notice any performance
regressions (or major improvements), I'd love to hear about them through an
issue report!

Also, for Windows users targeting MSVC, Cargo will now build fully static
executables of ripgrep. The release binaries for ripgrep 13 have been compiled
using this configuration.

BREAKING CHANGES:

Binary detection output has changed slightly.

In this release, a small tweak has been made to the output format when a binary
file is detected. Previously, it looked like this:

Binary file FOO matches (found "\0" byte around offset XXX)

Now it looks like this:

FOO: binary file matches (found "\0" byte around offset XXX)

vimgrep output in multi-line now only prints the first line for each match.

See issue 1866 for more
discussion on this. Previously, every line in a match was duplicated, even
when it spanned multiple lines. There are no changes to vimgrep output when
multi-line mode is disabled.

In multi-line mode, --count is now equivalent to --count-matches.

This appears to match how pcre2grep implements --count. Previously, ripgrep
would produce outright incorrect counts. Another alternative would be to simply
count the number of lines---even if it's more than the number of matches---but
that seems highly unintuitive.

FULL LIST OF FIXES AND IMPROVEMENTS:

Security fixes:

• CVE-2021-3013:
  Fixes a security hole on Windows where running ripgrep with either the
  -z/--search-zip or --pre flags can result in running arbitrary
  executables from the current directory.
• VULN #1773:
  This is the public facing issue tracking CVE-2021-3013. ripgrep's README
  now contains a section describing how to report a vulnerability.

Performance improvements:

• PERF #1657:
  Check if a file should be ignored first before issuing stat calls.
• PERF memchr#82:
  ripgrep now uses a new vectorized implementation of memmem.

Feature enhancements:

• Added or improved file type filtering for ASP, Bazel, dvc, FlatBuffers,
  Futhark, minified files, Mint, pofiles (from GNU gettext) Racket, Red, Ruby,
  VCL, Yang.
• FEATURE #1404:
  ripgrep now prints a warning if nothing is searched.
• FEATURE #1613:
  Cargo will now produce static executables on Windows when using MSVC.
• FEATURE #1680:
  Add -. as a short flag alias for --hidden.
• FEATURE #1842:
  Add --field-{context,match}-separator for customizing field delimiters.
• FEATURE #1856:
  The README now links to a
  Spanish translation.

Bug fixes:

• BUG #1277:
  Document cygwin path translation behavior in the FAQ.
• BUG #1739:
  Fix bug where replacements were buggy if the regex matched a line terminator.
• BUG #1311:
  Fix multi-line bug where a search & replace for \n didn't work as expected.
• BUG #1401:
  Fix buggy interaction between PCRE2 look-around and -o/--only-matching.
• BUG #1412:
  Fix multi-line bug with searches using look-around past matching lines.
• BUG #1577:
  Fish shell completions will continue to be auto-generated.
• BUG #1642:
  Fixes a bug where using -m and -A printed more matches than the limit.
• BUG #1703:
  Clarify the function of -u/--unrestricted.
• BUG #1708:
  Clarify how -S/--smart-case works.
• BUG #1730:
  Clarify that CLI invocation must always be valid, regardless of config file.
• BUG #1741:
  Fix stdin detection when using PowerShell in UNIX environments.
• BUG #1756:
  Fix bug where foo/** would match foo, but it shouldn't.
• BUG #1765:
  Fix panic when --crlf is used in some cases.
• BUG #1638:
  Correctly sniff UTF-8 and do transcoding, like we do for UTF-16.
• BUG #1816:
  Add documentation for glob alternate syntax, e.g., {a,b,..}.
• BUG #1847:
  Clarify how the --hidden flag works.
• BUG #1866:
  Fix bug when computing column numbers in --vimgrep mode.
• BUG #1868:
  Fix bug where --passthru and -A/-B/-C did not override each other.
• BUG #1869:
  Clarify docs for --files-with-matches and --files-without-match.
• BUG #1878:
  Fix bug where \A could produce unanchored matches in multiline search.
• BUG 94e4b8e3:
  Fix column numbers with --vimgrep is used with -U/--multiline.

ripgrep 12.1.1 is a patch release that fixes a couple small bugs. In
particular, the ripgrep 12.1.0 release did not tag new releases for all of its
in-tree dependencies. As a result, ripgrep built dependencies from crates.io
would produce a different build than compiling ripgrep from source on the
12.1.0 tag. Namely, some crates like grep-cli had unreleased changes.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern.
By default, ripgrep will respect your gitignore rules and automatically skip
hidden files/directories and binary files.

Bug fixes:

• BUG #1581:
  Corrects some egregious markup output in --help.
• BUG #1591:
  Mention the special $0 capture group in docs for the -r/--replace flag.
• BUG #1602:
  Fix failing test resulting from out-of-sync dependencies.

ripgrep 12.1.0 is a small minor version release that mostly includes bug fixes
and documentation improvements. This release also contains some important
notices for downstream packagers.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern. By
default, ripgrep will respect your .gitignore and automatically skip hidden
files/directories and binary files.

Notices for downstream ripgrep package maintainers:

• Fish shell completions will be removed in the ripgrep 13 release.
  See #1577
  for more details.
• ripgrep has switched from a2x to asciidoctor to generate the man page.
  If asciidoctor is not present, then ripgrep will currently fall back to
  a2x. Support for a2x will be dropped in the ripgrep 13 release.
  See #1544
  for more details.

Feature enhancements:

• FEATURE #1547:
  Support decompressing .Z files via uncompress.

Bug fixes:

• BUG #1252:
  Add a section on the --pre flag to the GUIDE.
• BUG #1339:
  Improve error message when a pattern with invalid UTF-8 is provided.
• BUG #1524:
  Note how to escape a $ when using --replace.
• BUG #1537:
  Fix match bug caused by inner literal optimization.
• BUG #1544:
  ripgrep now uses asciidoctor instead of a2x to generate its man page.
• BUG #1550:
  Substantially reduce peak memory usage when searching wide directories.
• BUG #1571:
  Add note about configuration files in --type-{add,clear} docs.
• BUG #1573:
  Fix incorrect --count-matches output when using look-around.

ripgrep 12.0.1 is a small patch release that includes a minor bug fix relating
to superfluous error messages when searching git repositories with sub-modules.
This was a regression introduced in the 12.0.0 release.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern. By
default, ripgrep will respect your .gitignore and automatically skip hidden
files/directories and binary files.

Bug fixes:

• BUG #1520:
  Don't emit spurious error messages in git repositories with submodules.

ripgrep 12 is a new major version release of ripgrep that contains many bug
fixes, several important performance improvements and a few minor new features.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern. By
default, ripgrep will respect your .gitignore and automatically skip hidden
files/directories and binary files.

In a near future release, I am hoping to add an
indexing feature
to ripgrep, which will dramatically speed up searching by building an index.
Feedback would very much be appreciated, especially on the user experience
which will be difficult to get right.

This release has no known breaking changes.

Deprecations:

• The --no-pcre2-unicode flag is deprecated. Instead, use the --no-unicode
  flag, which applies to both the default regex engine and PCRE2. For now,
  --no-pcre2-unicode and --pcre2-unicode are aliases to --no-unicode
  and --unicode, respectively. The --[no-]pcre2-unicode flags may be
  removed in a future release.
• The --auto-hybrid-regex flag is deprecated. Instead, use the new --engine
  flag with the auto value.

Performance improvements:

• PERF #1087:
  ripgrep is smarter when detected literals are whitespace.
• PERF #1381:
  Directory traversal is sped up with speculative ignore-file existence checks.
• PERF cd8ec38a:
  Improve inner literal detection to cover more cases more effectively.
  e.g., +Sherlock Holmes + now has Sherlock Holmes extracted instead
  of .
• PERF 6a0e0147:
  Improve literal detection when the -w/--word-regexp flag is used.
• PERF ad97e9c9:
  Improve overall performance of the -w/--word-regexp flag.

Feature enhancements:

• Added or improved file type filtering for erb, diff, Gradle, HAML, Org,
  Postscript, Skim, Slim, Slime, RPM Spec files, Typoscript, xml.
• FEATURE #1370:
  Add --include-zero flag that shows files searched without matches.
• FEATURE #1390:
  Add --no-context-separator flag that always hides context separators.
• FEATURE #1414:
  Add --no-require-git flag to allow ripgrep to respect gitignores anywhere.
• FEATURE #1420:
  Add --no-ignore-exclude to disregard rules in .git/info/exclude files.
• FEATURE #1466:
  Add --no-ignore-files flag to disable all --ignore-file flags.
• FEATURE #1488:
  Add '--engine' flag for easier switching between regex engines.
• FEATURE 75cbe88f:
  Add --no-unicode flag. This works on all supported regex engines.

Bug fixes:

• BUG #1291:
  ripgrep now works in non-existent directories.
• BUG #1319:
  Fix match bug due to errant literal detection.
• BUG #1335:
  Fixes a performance bug when searching plain text files with very long lines.
  This was a serious performance regression in some cases.
• BUG #1344:
  Document usage of --type all.
• BUG #1389:
  Fixes a bug where ripgrep would panic when searching a symlinked directory.
• BUG #1439:
  Improve documentation for ripgrep's automatic stdin detection.
• BUG #1441:
  Remove CPU features from man page.
• BUG #1442,
  BUG #1478:
  Improve documentation of the -g/--glob flag.
• BUG #1445:
  ripgrep now respects ignore rules from .git/info/exclude in worktrees.
• BUG #1485:
  Fish shell completions from the release Debian package are now installed to
  /usr/share/fish/vendor_completions.d/rg.fish.

ripgrep 11.0.2 is a new patch release that fixes a few bugs, including a
performance regression and a matching bug when using the -F/--fixed-strings
flag.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern. By
default, ripgrep will respect your .gitignore and automatically skip hidden
files/directories and binary files.

Feature enhancements:

• FEATURE #1293:
  Added --glob-case-insensitive flag that makes --glob behave as --iglob.

Bug fixes:

• BUG #1246:
  Add translations to README, starting with an unofficial Chinese translation.
• BUG #1259:
  Fix bug where the last byte of a -f file was stripped if it wasn't a \n.
• BUG #1261:
  Document that no error is reported when searching for \n with -P/--pcre2.
• BUG #1284:
  Mention .ignore and .rgignore more prominently in the README.
• BUG #1292:
  Fix bug where --with-filename was sometimes enabled incorrectly.
• BUG #1268:
  Fix major performance regression in GitHub x86_64-linux binary release.
• BUG #1302:
  Show better error messages when a non-existent preprocessor command is given.
• BUG #1334:
  Fix match regression with -F flag when patterns contain meta characters.

ripgrep 11.0.1 is a new patch release that fixes a search regression introduced
in the previous 11.0.0 release. In particular, ripgrep can enter an infinite
loop for some search patterns when searching invalid UTF-8.

Bug fixes:

• BUG #1247:
  Fix search bug that can cause ripgrep to enter an infinite loop.

ripgrep 11 is a new major version release of ripgrep that contains many bug
fixes, some performance improvements and a few feature enhancements. Notably,
ripgrep's user experience for binary file filtering has been improved. See the
guide's new section on binary data for more details.

In case you haven't heard of it before, ripgrep is a line-oriented search
tool that recursively searches your current directory for a regex pattern. By
default, ripgrep will respect your .gitignore and automatically skip hidden
files/directories and binary files.

This release also marks a change in ripgrep's versioning. Where as the previous
version was 0.10.0, this version is 11.0.0. Moving forward, ripgrep's
major version will be increased a few times per year. ripgrep will continue to
be conservative with respect to backwards compatibility, but may occasionally
introduce breaking changes, which will always be documented in this CHANGELOG.
See issue 1172 for a bit
more detail on why this versioning change was made.

This release increases the minimum supported Rust version from 1.28.0 to
1.34.0.

BREAKING CHANGES:

• ripgrep has tweaked its exit status codes to be more like GNU grep's. Namely,
  if a non-fatal error occurs during a search, then ripgrep will now always
  emit a 2 exit status code, regardless of whether a match is found or not.
  Previously, ripgrep would only emit a 2 exit status code for a catastrophic
  error (e.g., regex syntax error). One exception to this is if ripgrep is run
  with -q/--quiet. In that case, if an error occurs and a match is found,
  then ripgrep will exit with a 0 exit status code.
• Supplying the -u/--unrestricted flag three times is now equivalent to
  supplying --no-ignore --hidden --binary. Previously, -uuu was equivalent
  to --no-ignore --hidden --text. The difference is that --binary disables
  binary file filtering without potentially dumping binary data into your
  terminal. That is, rg -uuu foo should now be equivalent to grep -r foo.
• The avx-accel feature of ripgrep has been removed since it is no longer
  necessary. All uses of AVX in ripgrep are now enabled automatically via
  runtime CPU feature detection. The simd-accel feature does remain available
  (only for enabling SIMD for transcoding), however, it does increase
  compilation times substantially at the moment.

Performance improvements:

• PERF #497,
  PERF #838:
  Make rg -F -f dictionary-of-literals much faster.

Feature enhancements:

• Added or improved file type filtering for Apache Thrift, ASP, Bazel, Brotli,
  BuildStream, bzip2, C, C++, Cython, gzip, Java, Make, Postscript, QML, Tex,
  XML, xz, zig and zstd.
• FEATURE #855:
  Add --binary flag for disabling binary file filtering.
• FEATURE #1078:
  Add --max-columns-preview flag for showing a preview of long lines.
• FEATURE #1099:
  Add support for Brotli and Zstd to the -z/--search-zip flag.
• FEATURE #1138:
  Add --no-ignore-dot flag for ignoring .ignore files.
• FEATURE #1155:
  Add --auto-hybrid-regex flag for automatically falling back to PCRE2.
• FEATURE #1159:
  ripgrep's exit status logic should now match GNU grep. See updated man page.
• FEATURE #1164:
  Add --ignore-file-case-insensitive for case insensitive ignore globs.
• FEATURE #1185:
  Add -I flag as a short option for the --no-filename flag.
• FEATURE #1207:
  Add none value to -E/--encoding to forcefully disable all transcoding.
• FEATURE da9d7204:
  Add --pcre2-version for querying showing PCRE2 version information.

Bug fixes:

• BUG #306,
  BUG #855:
  Improve the user experience for ripgrep's binary file filtering.
• BUG #373,
  BUG #1098:
  ** is now accepted as valid syntax anywhere in a glob.
• BUG #916:
  ripgrep no longer hangs when searching /proc with a zombie process present.
• BUG #1052:
  Fix bug where ripgrep could panic when transcoding UTF-16 files.
• BUG #1055:
  Suggest -U/--multiline when a pattern contains a \n.
• BUG #1063:
  Always strip a BOM if it's present, even for UTF-8.
• BUG #1064:
  Fix inner literal detection that could lead to incorrect matches.
• BUG #1079:
  Fixes a bug where the order of globs could result in missing a match.
• BUG #1089:
  Fix another bug where ripgrep could panic when transcoding UTF-16 files.
• BUG #1091:
  Add note about inverted flags to the man page.
• BUG #1093:
  Fix handling of literal slashes in gitignore patterns.
• BUG #1095:
  Fix corner cases involving the --crlf flag.
• BUG #1101:
  Fix AsciiDoc escaping for man page output.
• BUG #1103:
  Clarify what --encoding auto does.
• BUG #1106:
  --files-with-matches and --files-without-match work with one file.
• BUG #1121:
  Fix bug that was triggering Windows antimalware when using the --files
  flag.
• BUG #1125,
  BUG #1159:
  ripgrep shouldn't panic for rg -h | rg and should emit correct exit status.
• BUG #1144:
  Fixes a bug where line numbers could be wrong on big-endian machines.
• BUG #1154:
  Windows files with "hidden" attribute are now treated as hidden.
• BUG #1173:
  Fix handling of ** patterns in gitignore files.
• BUG #1174:
  Fix handling of repeated ** patterns in gitignore files.
• BUG #1176:
  Fix bug where -F/-x weren't applied to patterns given via -f.
• BUG #1189:
  Document cases where ripgrep may use a lot of memory.
• BUG #1203:
  Fix a matching bug related to the suffix literal optimization.
• BUG 8f14cb18:
  Increase the default stack size for PCRE2's JIT.