Release Notes: Sprint 25

This is a draft!

This document will not be finalized until the end of Sprint 25 -- approximately May 21.

What's New in Sprint 25

• Live Preview
  • Improved connection reliability: No longer need to restart Chrome on Windows. If the Live Preview connection is lost, Brackets gives the reason why.
• Extensions
  • Extension manager: Listing of your currently installed extensions. Easier to uninstall extensions.
• File Management
  • Refresh file tree: Right-click on the file tree and choose Refresh to update the file list from disk – no need to restart Brackets. (This is a stopgap along the way to fully automatic refresh, which will come further down the road).
  • Delete file/folder: Right-click in the file tree an choose Delete to move a file or entire folder to the trash.
  • Show file/folder in OS: Right-click in the file tree or working files list and choose Show in OS to show a file or folder in Windows Explorer or Mac Finder.
• Search
  • Faster, more accurate Quick Edit for JavaScript: Now using the Tern code intelligence engine that powers code hints and Jump to Definition.
• Code Editing
  • Many bug fixes in JavaScript code hinting
  • Improved typing performance: ...........

Full change logs: brackets and brackets-shell

UI Changes

New visual design for Quick Open / Quick Find Definition, JSLint panel, and Find in Files results panel.

API Changes

Extension package format - All extensions should now include a package.json file with descriptive metadata. See Extension package format for details. Extensions that omit package.json will still work, but won't look very nice in the new Extension Manager dialog. (Down the road, package.json will become required though).

Adding panels -

• To add a resizable panel below the editor, use PanelManager.createBottomPanel(). The previous approach (insert DOM node manually, then call Resizer.makeResizable()) still works, but is deprecated.
• To show/hide a panel, use Resizer's APIs or the Panel object returned by PanelManager. Again, the old approach (call jQuery show()/hide(), then call EditorManager.resizeEditor()) still works for now, but is deprecated.

ProjectManager - Previously, ProjectManager.getSelectedItem() returned null when the selection highlight was in the working set instead of the file tree. Now it returns whatever file/folder is selected anywhere in the sidebar (working set or file tree). (Note that is may still return null in some cases when a current document is open - for example if a Find in Files result was clicked and the opened file is not visible anywhere in the sidebar, the sidebar will have no selection).

QuickOpen - The search heuristic no longer automatically applies special weighting when items look like a path. Quick Open providers can switch back to the path-oriented behavior by supplying matcherOptions: { segmentedSearch: true } in the settings passed to addQuickOpenPlugin().

Sidebar show/hide - SidebarView.toggleSidebar() was renamed to toggle(). Added new show(), hide(), and isVisible() methods.

New/Improved Extensibility APIs

QuickOpen / StringMatch - In addition to the segmentedSearch option described above, Quick Open providers can also specify matcherOptions: { preferPrefixMatches: true } to give additional weighting when the search text is an exact prefix of some results. The same options can be passed to the raw StringMatch API as a constructor argument. (Prefix weighting is useful for sorting code hint matches, for example – which would typically use a raw StringMatcher for sorting).

Font size event - ViewCommandHandlers dispatches a "fontSizeChange" event whenever the editor font size is changed by the user.

showOSFolder() - The existing brackets.app.showOSFolder() API can now be passed a file instead of a folder. It will open the containing folder with that file pre-selected.

Known Issues

• Mountain Lion (OS X 10.8) by default will not allow Brackets to run since it's not digitally signed yet. To work around this, right click the Brackets app and choose Open. You only need to do that once -- afterward, launching Brackets the normal way will work also.
• #2272: Windows Vista may not allow the Brackets installer to run (you may not see any error message). To work around this, right-click the installer file, choose Properties, and click the Unblock button.
• #3458: Quick View does not yet support the latest CSS gradient syntax (using to keyword, unprefixed radial-gradient, repeating-linear-gradient or repeating-radial-gradient).
• #3570: Mac only - Quick View popover may not appear after resizing window or going fullscreen. Move the mouse to the top of the screen to fix. (https://github.com/adobe/brackets/wiki/How-to-Hack-on-Brackets#wiki-getcode) instead.
• #3207: If you use a Sprint 21 or earlier build after using this build at least once, a few preferences such as Recent Projects may get reset. (You can back up your cache folder if you're concerned about this).
• Debug > Run Tests is disabled in the installer/DMG distributions of Brackets, because the unit test code is not included. To run unit tests, pull Brackets from GitHub instead.

Community contributions to Brackets

• Make JSLint error messages selectable in JSLint panel by Jeffrey Fisher
• Color-code Handlebars .hbs files as HTML by Thomas Carlsen
• Color-code Kit .kit files as HTML by Tucker Whitehouse
• Color-code Embedded JS .ejs & Java .jsp files as HTML by Tucker Whitehouse
• Fix #3723: Allow replacing non-multi-line selection with Tab character by Jeffrey Fisher
• Fix #3679: File extension isn't color-coded if created via File > New by Rajesh Segu
• Restore useful error messages when addMenuItem() is passed bad arguments by Tomás Malbrán
• Fix #3637: Incorrect selection indicator after loading Brackets with sidebar hidden by Jeffrey Fisher
• Partial fix for #3478: 1px top border sometimes appears on search result highlight by Tomás Malbrán
• Fix #3773: Only show '"The maximum number of files have been indexed' error once per project (per session) by dschaffe
• Fix incorrect plural in statusbar for 1-line files by Tomás Malbrán
• Speed improvement to CollectionUtils.hasOwnProperty() by Rajesh Segu
• Add ViewCommandHandlers "fontSizeChange" event by Lance Campbell
• Add cleaner APIs for sidebar panel: isVisibile(), show(), hide() (and) by Lance Campbell
• Cleanup: Use Mustache templates for some of the Debug commands' UI by Tomás Malbrán
• Cleanup: Upgrade Mustache version by Bernhard Sirlinger
• Cleanup: Use submodules for RequireJS text & i18n plugins by Tucker Whitehouse
• Cleanup: Stop using jQuery.toggleClass() due to argument type bug-proneness by Bernhard Sirlinger
• Cleanup: Stop using deprecated Promise.isResolved()/isRejected() by Tucker Whitehouse
• Cleanup: Stop using deprecated CodeMirror token.className by Jeffrey Fisher
• Cleanup: Group strings used by default extensions by Tomás Malbrán
• Cleanup: Remove unused string by Tomás Malbrán
• Unit tests for HTML entity code hints (and) by Bernhard Sirlinger
• Localize language names in Debug > Switch Language dropdown by Tammo Pape
• Fix unlocalized string "pixels" in Quick View popup by Kieran Gorman
• German translation update by mynetx
• Spanish translation update by Chema Balsas

Contributions from the Brackets community

Contributions to CodeMirror:

• CSS mode: record better info for @import directives (enables Brackets URL hinting when typing an @import)
• Don't continue line numbers next to horizontal scrollbar
• vim mode: Fix dialog box used for ':' commands

Contributions to Tern:

• Fix capitalization error in jQuery API hint

Bugs fixed in Sprint 25

For details on the bugs addressed, please refer to closed sprint 25 bugs. A few of the fixed bugs might not be caught by this search query, however.