Drafts

Smoothing out some rough edges in a mostly bug-fix release.

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

Better task support and a task widget.

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

A few quick fixes for the v40 release.

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

Ready for the latest OS! New tag filtering interface, Command Palette, Quick Search, and more.

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

Disable Twitter integration due to policy changes at Twitter.

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

A few fixes since the 39.0 release. Don't miss the new ChatGPT-OpenAI support in the previous release!

For complete details on new features, bug fixes, and related documentation, visit “What's New” in the Help menu, or:
https://docs.getdrafts.com/changelog

For additional details, sample actions utilizing new features and more, visit the online release notes at http://docs.getdrafts.com/docs/misc/changelog-mac

#### What's New

- Wiki-style markup for cross-linking between drafts, and executing basic Drafts commands. When embedded in a draft, these become tappable links which open URLs as described below:
- `[[Title of Draft]]` : Creates a link which will open a draft by title (first line) when clicked/tapped. Will create a draft with the title if it does not exist.
- `[[u:UUID-OF-DRAFT]]` : Link to a specific draft by UUID.
- `[[s:Search Term]]` : Link to open a quick search to the specified search.
- `[[w:Workspace Name]]` : Link to load the named workspace
- `[[google:Search term]]` : Opens a Google search for "Search term" when clicked/tapped.
- `[[wikipedia:Search term]]` : Opens a Wikipedia page for "Search term" when clicked/tapped.
- `[[bear:Title of Bear Note]]` : Opens a note titled "Title of Bear Note" in Bear, if it exists.
- Link markers are only available when using Markdown, MultiMarkdown or GitHub Markdown syntax definitions.
- "Typewriter Scrolling" option fixes the cursor position in the middle of the editor, moving the text as you type. Feature can be enabled/disabled in the "Aa" editor settings, or via contextual menu (tap and hold) on the "Aa" button.
- Navigate menu (down-arrow in top right) now has additional options for navigating to recent drafts.
- Scripting additions:
- JavaScript objects now support `new` keyword. So `new Draft()` now works in lieu of `Draft.create()` (old syntax still works).
- `Draft` object additions and changes:
- `title` property now strictly returns first line of draft
- `displayTitle` property returns cleaned up title as it would be displayed in draft list.
- `lines` returns content as array of strings split on line feeds.
- `editor.recentDrafts` returns array of recent drafts loaded in the editor, with the most recent previous draft as the first index.
- `app.openInNewWindow(draft)` script method. (iPad/Mac).
- Scripting access to editor navigation markers, as displayed in the Navigation window/menu. Allows for the creation of actions which navigate within the current document.
- `editor.navigationMarkers`: Array of navigation markers available in the document.
- `editor.navigationMarkerAfter(location: number)` and `editor.navigationMarkerBefore(location: number)` convenience methods to get the next/previous navigation markers relative to a location in the text.
- Visit reference for details.
- `FileManager` has new `getCreationDate(path)`, `getModificationDate(path)`, and `setCreationDate(path, date)` and `setModificationDate(path, date)` functions.
- `File` action step has new "Maintain dates" option which will set the creation/modification date of the newly created file to match those of the current draft.
- `File` action step has new "Maintain dates" option which will set the creation/modification date of the newly created file to match those of the current draft. When the action create a new file, creation and modification will be set - if it is appending/prepending, only modification date will be updated. [Docs](https://docs.getdrafts.com/docs/actions/steps/services#file)
- Add option to copy title to clipboard in locations where there are copy options.
- Contextual menus on drafts in Quick Search results.

#### Other Changes and Updates

Too many other updates to fit here, for full details visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

Make sure you check out Quick Search and AppleScript support in the previous release!

- **Change:** Improved keyboard navigation in and initial positioning of find panel.
- **Change:** Make insertion point more prominent in the editor.
- **Fix:** "Send to Drafts" service should open the draft created when run.
- **New:** Reset sync state button in preferences. Used only for resolving certain sync issues when recommended by support.
- **Fix?:** Possible fix for issue where merge function in draft list contextual menu would stop functioning after the app had been running for a while.
- **Fix:** Exporting a file from `Run AppleScript` editor should export with `.applescript` file extension.
- **Fix?:** Possible fix for case where quick search can get stuck beach balling for some users.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

- **Quick Search**: Global quick search feature to query for drafts, actions, workspaces and common commands in one place.
- Accessed via search button in the toolbar, the `Edit > Find > Quick Search` menu command, or `shift-command-F` keyboard shortcut.
- `/quickSearch?query=` URL action to open directly to quick search.
- `app.showQuickSearch(initialQuery)` scripting function.
- Quick Search feature requires macOS 10.15.1 (Catalina) or greater.

- **AppleScript**
- "Run AppleScript" action step can be used to execute AppleScripts passing information about the current draft.
- `AppleScript` script object for calling AppleScripts from JavaScript, with more advanced control of parameters, subroutines called, and easier access to return values.
- Basic incoming AppleScript support for creating new drafts. Additional support for AppleScript coming in future updates. Example: `tell application "Drafts" make new draft with properties {content: "my draft", tags: {"blue", "green"}} end tell`
- For example actions and details: https://docs.getdrafts.com/docs/automation/AppleScript

- `ShellScript` script object for running Unix shell scripts from Drafts script action steps, with the ability to pass command line arguments, and access standard output and errors.

- **Marked app streaming preview support**. If enabled in `Preferences > General`, the editor will live update the stream Marked watches in it's "Streaming Preview" window. Requires Marked app be installed.

- `FileManager` script object additions:
- `baseURL` and `basePath` properties return full `file:///` URL or POSIX path to the base directory used by the FileManager instance. This can be useful in cases where the full location of files is needed.
- `writeJSON(path, obj)` and `readJSON(path)` convenience functions for saving and restoring JavaScript objects in files.
- `app.showDraftInfo(draft?)` function to display details of a draft.
- Additional `Workspace` script object properties:
- `loadActionListGroup` (ActionGroup)
- `loadActionBarGroup` (ActionGroup)
- `loadFolder` ("inbox" | "archive" | "trash" | "flagged")

### Other Changes

- **Fix:** Better live updating of changes if the same draft is open in multiple windows.
- **Fix:** Changing only some advanced settings in the action editor, and nothing else, could result in the change not being saved.
- **Fix:** "-" button for deleting actions in action manager did not work properly with multiple selections.
- **Change:** Searches now also search tag names in addition to searching full text.
- **Fix:** "Manage Actions" window did not behave properly in full screen mode.
- **Fix:** Several crashes related to open and closing additional drafts windows when the app first launched.
- **Change:** Improve identification of HTML tags in Markdown syntax.
- **Fix:** Crash in find and replace window when certain items were selected.
- Misc. other reliability and performance improvements.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

- **New:** Several additional icon grouping for use on actions and workspaces.
- **Change:** The `/workspace` URL action can now accept the `name=Default` argument to clear filters and load the default workspace.
- **Fix:** Task marks in TaskPaper syntax should only be recognized at beginning of lines.
- **Fix:** Clicking in editor margins should still allow text selection.
- **Fix:** Crash using "Run Action" from contextual menu on draft list.
- **Fix:** Clearing a keyboard shortcut on an action might not save if no other changes were made to the action.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

- Clickable tasks in TaskPaper syntax. Clicking the list mark at the beginning of a TaskPaper task line will now add-remove the `@done` status for that line in drafts using TaskPaper syntax.
- TaskPaper example action group. If you are interested in using TaskPaper, we have created an example TaskPaper action group designed for use in the Action Bar with many common TaskPaper commands, to add tasks, assign due/start dates to selected lines and archive done items. Visit the Action Directory to download this group. (https://actions.getdrafts.com/)
- **New:** `File > New with Syntax` menu items to create new drafts with a specific syntax already assigned.
- **New:** Ability to edit action bar label for separators.
- **New:** Added ability to view action log for only the current draft, from popover below editor.

### Other Changes and Updates
- **Fix:** Addressed most known crashing issues.
- **Change:** Audit of how/when draft version history entries are automatically created. Should be more reliable capturing some state changes and avoiding duplicate versions.
- **Fix:** Targeting specific OneNote notebook might not work in some cases with OneNote action steps.
- **Fix:** Issue with reordering action groups not working properly with certain data sets.
- **Fix:** Possible issue reordering workspaces with certain data sets.
- **Fix:** If a draft was selected for appending in the capture window, then opened and editing in the main window, returning to capture and appending additional text without reselecting the draft for appending could result is overwriting main window edits.
- **Change:** Periodically reset sync log if logging is enabled to prevent excessive log sizes.
- **Fix:** Global shortcut for main window should bring app to front if window is already visible but not active.
- **Fix:** Issue with text flicker and dissapearance when clicking task marks.
- **Fix:** Be less agressive reloading draft list on some functions to avoid visual glitches reloading list.
- **Fix:** Layout glitch changing margins in editor preferences.
- **Fix:** Workaround alignment issue for strings beginning line with a smart quote.
- **Fix:** Toolbar items in main window were not activated properly in the overflow menu which appears when the window is too narrow to display all items.
- **Change:** Increase priority of action pane toolbar items so they are less likely to be collapsed into overflow menu when window is too narrow.
- **Fix:** Select action view should remember last selected action group.
- **Fix:** Better position action selection window when using "Run Action" from drafts list context menu.
- **Fix:** Changes in the editor could be overwritten if using the context menu on the draft list to alter the same draft before a save occured.
- **Fix:** Background colors applied by syntax highlighting (as inline code) might not get cleared immediately if the text changed it ways that should disable that background color.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

- **New:** Workspace sharing. Workspaces can now be shared via URL or export file which can be installed in other instances of Drafts. This can be used to backup workspaces, or to share configured workspaces with other Drafts users.
- **New:** `Reminder` script object has new `dueDateIncludesTime` boolean property. If true, the time components of the dueDate will be ignored allow Reminders to be set to be due on a date without assigning a time.
- **Change:** `Mail.send` and `Message.send` APIs now work on Mac for foreground messages/mail.
- **New:** `Share` scripting methods now implemented for Mac (previous iOS only). These allow sharing as file or URL in addition to simply trigger the system share sheet from scripts.
- **Change:** Allow ESC key to close capture window (without saving). Matches CMD-W (close window) shortcut which already worked. (Note you can use CMD-Enter to save and close the window, same as clicking "Save" button.)
- **Fix:** Properly update editor margins when entering and exiting full screen mode.
- **Change:** Updates to default action groups installed with new installations.
- **Change:** Reworked sharing buttons in actions and actions groups management screens.
- **Change:** Better action logging in Dropbox actions.
- **Change:** OneNote actions will now prompt for the selection of a notebook if a notebook name is not specified and the default notebook cannot be determined.
- **Fix:** Text views in prompts did not scroll properly with longer texts.
- Misc. improvements and minor fixes for several sync and useability issues.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac

Editor improvements, TouchBar support, Medium posting and more...

### Editor Improvements

- Highlight insertion point option to draw different background for current cursor position.
- Editor setting to limit max characters per line**. Works along with margin settings to determine a maximum line length. Great for use with full screen mode to prevent excessively long lines.

### Other Additions

- "Run Action" option in drafts list contextual menu. Allows action to be run on multiple selected drafts. Select drafts and right-click to access.
- TouchBar support (when available). Uses same configuration options as to display and provide quick access to actions.
- Two new monochrome editor themes. Available to select in `File > Editor Preferences...`
- `Medium` action step type to post to Medium.com. Visit action directory for example actions.
- `Medium` script object to support scripting Medium API.
- Script steps now have a new "Allow asynchronous execution" option. When enabled, the action will wait for a call to `script.complete()` to know if a script step is finished. This allows use of async/await, Promises and other async function calls...but your script *must* call `script.complete()` of the action will timeout and fail after 60 seconds.
- `CallbackURL` objects have a read-only `url` property to debug the URL which will be used with the configured parameters.

### Other Fixes and Changes

- Hiding action group from list should not remove it from main menu.
- `Filemanager.readString` would not return undefined properly when file was not found.
- Inaccurate action directory URLs used for opening actions posted to the directory.
- Appending to a flagged draft from the capture window could unflag the draft.
- Misc. additional fixes and stability improvements.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac.

Don't miss all the great new actions features in 16.0!

- **New:** Print action steps can now specify page margins (in points). This allows margins less than the default 72pt (1 inch) setting.
- **Change:** Switch to custom link identifier in Link mode to fix a few issues with URL highlighting with data detectors. Among other things, `message:` links now work properly.
- **Fix:** Triggering a dictation action on unsupported OS version would report problem, but not properly finish the failed action.
- **Fix:** Issue that could prevent extended dictation from working properly if the system timed out listening.
- **Fix:** Vertically align select items in prompts to avoid clipping.
- **Fix:** Issue hidding action bar on 10.13 (High Sierra).
- **Change:** Tighten authorization scopes requested by Gmail actions based to avoid Google verification issue.
- **Fix:** Fix for issue where scripted alert might not appear when action was run by being queued in another action.

For a complete history of updates, visit the changelog: https://docs.getdrafts.com/docs/misc/changelog-mac.

For more detail, links to docs, and change history, visit: https://docs.getdrafts.com/docs/misc/changelog-mac

- **Fix:** Improvements to sync prioritization to avoid some issues where sync changes were not being delivered in a timely fashion.

More feature updates coming soon!

For more detail, links to docs, and change history, visit: https://docs.getdrafts.com/docs/misc/changelog-mac

- **Fix:** Performance improvements editing large MultiMarkdown drafts.
- **Fix:** Fix for timing issue with URL calls which update the draft loaded in the editor.
- **Change:** Move flagged indicator to title line in the draft list to allow more compact presentation.
- **Fix:** Minor changes to the way items in draft list are refreshed when changes occur.
- **Change**: Built with the most recent updates to system SDKs.

# R15 - What's New - Mac

For more detail, links to docs, and change history, visit: https://getdrafts.com/changelog-mac

## Related Updates

Along with this update, we will also be launching new User Guide and Scripting Reference websites, dramatically improving the available Drafts support documentation. Please visit these sites for more information and to get involved in the Drafts community:

https://docs.getdrafts.com
https://scripting.getdrafts.com
https://forums.getdrafts.com

## Workspaces & Draft List

- **"Default" Workspace**. This is a special workspace that stores the preferred default settings for the draft list, and is applied when filters are cleared. This way, if you have workspaces that applies sort or display settings, clearing the list filters will also reset those back to your preferred default settings. The default workspace can be configured like any other workspace in the workspace manager. Workspaces are a Pro feature, but the default workspace is available in the free version.
- **"Show Date" display option for drafts list and workspaces**. Hide/show the date in the list. Along with other display settings, this allows everything but the draft title to be removed, for the minimalists out there.

## Other Updates

- **New:** Add focus mode toggle button in editor (bottom row)
- **New:** Add "Launch in focus mode" preference.
- **Change:** Markdown preview windows now maintain scroll position when updating content and enforce a minimum size.
- **Change:** All default Markdown Preview styles (Basic, Swiss, Foghorn) now support dark mode in CSS.
- **Fix:** Markdown syntax definitions did not handle reference link properly.
- **Change:** Updates to Find window, allowing multiple line texts and treating whitespace escape characters properly (\n, \t) in regular expression mode.
- **New:** Extensions tab in preferences, to allow configuration of share extension options.
- **Change:** If a selection is present in the editor, the character / word counts at bottom right now include a selection character count as well.
- **Fix:** Issue preventing Handoff from working properly from Mac to iOS.
- - **Fix:** Improve markdown header recognition in syntax highlighting definitions to allow # in header text.
- **Change:** File > Copy and Share menu items now work when draft is open in separate window.
- **Change:** "Backup Now" in Preferences > Backup now prompts for save location rather than saving to iCloud Drive.
- **New:** Bulk export options in context menu of draft list to allow export of selected drafts as JSON, CSV or text file.
- **Change:** Better handling of restore purchase process to help avoid confusion about the fact that you can't restore iOS purchases on the Mac.

- **Fix:** Glitch with link mode and checkboxes.

For details and change history at https://getdrafts.com/changelog-mac

- **Fix:** Rewrote link mode (it was broken in last release). Should behave the same, other than links now being underlined.
- **Fix:** Fix performance and excessive logging issue in sync.
- **Fix:** Issue entering tags using characters in some (particularly Asian) languages.

For details and change history at https://getdrafts.com/changelog-mac

- **Fix:** Fix for draft list appearing blank when first shown on 10.13 (High Sierra).
- **Fix:** Fix for garbage text issue when fonts are re-assigned by syntax highlighting, usually visible when using code blocks.
- **Fix:** Word/character count not properly updating for multiple windows.
- **Fix:** Sync timing issue that could cause some changes (typically archiving or trashing of a draft) to not get synced to other devices properly.
- **Fix:** Workaround a couple minor issues when running on as yet unreleased software.

For details and change history at https://getdrafts.com/changelog-mac

## What's New
- **New:** Capture window will float over other full screen apps and generally behave more nicely with other apps.
- **New:** Arrange mode now supports arranging by sentence in addition to blocks and lines. This feature requires 10.14 (Mojave).
- **New:** Right-click context menu commands in arrange mode to allow access to move to top-bottom and duplicate commands.

## Other Changes and Fixes
- **Change:** Alpha sort tags when displayed in draft list.
- **Fix:** Preview characters would not match text size when using some Asian language input methods.
- **Fix:** Drafts should not prevent shutdown when running.
- **Fix:** If main window is visible but minaturized to dock, re-open it when clicking on Dock icon.
- **Fix:** Do not re-open main window just when becoming the active app (e.g. via cmd-tab switching)
- **Fix:** Crashing bug when moving certain selections of drafts to a different folder, depending on specific sequence selecting them.
- **Fix:** Do not show main window re-activating app if floating draft window was already open.
- **Fix:** Displayed modified date not updated in draft list when changes made to a draft.

For complete update history, visit: https://getdrafts.com/changelog-mac

- **New:** Add "Window > Float Selected Draft" menu item to open new draft window.
- **New:** Add "Window > Float Selected Draft On Top" menu item to open new draft window floating over other applications.
- **Fix:** Drafts in floating windows should support all Editor menu commands.
- **New:** Button in title bar to toggle "on top" floating status of draft windows.
- **New:** Add "Editor > Navigate" menu item to trigger navigation.
- **Change:** Remove "Navigate" top level main menu item.
- **New:** Add periodic check for subscription status changes
- **Fix:** If same draft was loaded in main editor as other open windows, and the app became inactive directly after making edits, the edits could revert.
- **Fix:** Workspace editor would mis-select sort order for "all" folder when changing flagged sort.
- **New:** Update to MultiMarkdown 6.4.0 (was on 6.3.2).

For complete update history, visit: https://getdrafts.com/changelog-mac

#### What's New

- **New: MULTIPLE WINDOWS!** Double click a draft in the draft list to open it in a separate window.
- **New:** Badge notification preferences now allow badge count to be based on a selected workspace's inbox only.
- **New:** Add "Maps" button to created/modified locations in draft detail to allow opening the location in Maps.
- **New:** Display device along with created, modified dates in draft detail allow referencing whether the draft was created or last modified on Mac, iPhone or iPad.
- **New:** Moved navigation function from toolbar to within editor. Now responds to `CMD-\` to popup anywhere in draft as well.

#### Other Changes and Fixes

- **Fix:** Hide find panel with window that opened it.
- **Change:** Change tag token field behavior to avoid all existing tags being selected when entering the field.
- **Fix:** Better handling of sync changes which trash/delete drafts which are loaded in the editor.
- **Fix:** Deselecting a draft from a range of drafts would not remove it from a subsequent merge operation.
- **Change:** Be more aggressive about trying to sync any pending changes on application quit.
- **Fix:** Improve tint color selector in icon selection popover in Workspace editor.
- **Change:** Empty state in drafts list and capture window draft list.
- **Fix:** Don't open main window when activating app if capture window is already visible.
- **Change:** Misc. UI tweaks.

For complete update history, visit: https://getdrafts.com/changelog-mac

- **Fix:** "Open main window on launch" preference was not working properly.
- **Fix:** Prevent task marks from being marked as grammar errors when grammar checking is enabled.
- **Fix:** Hopefully a fix for case where duplicate drafts could get created from Share extension or other URL calls.
- **Change:** If HTML passed to HTML Prevew has a `title` element, use that title as the window title.
- **Fix:** Several VoiceOver labels in preferences.
- **Fix:** New blank line at end of draft did not have the right line height/style until something was typed on the line.
- **Fix:** Merge operation did not properly pickup selected rows if you shift-selected a range for rows in list.

**New Version Numbering**: *Moving forward, each feature release of Drafts will get a major version number. Minor version numbers will still be used for bug fix and minor releases. If you look back, it's the same thing we've been doing, but we're dropping the "5".*

For complete update history, visit: https://getdrafts.com/changelog-mac

- **New:** "New in Workspace" option in File menu to create new draft with workspace tags already assigned.
- **Change:** Better HTML output for fenced code block when using GitHub Markdown option.
- **Change:** Edit > Find > Search Drafts (shift-command-F) should work in Capture window.
- **Fix:** Better handling of activation of the app when no windows are visible.
- **Change:** Support broader data types in share extension.

For complete details and change history, please visit https://getdrafts.com/changelog-mac

A few quick fixes and a few new commands for managing tags/merging.

#### What's New

- **New:** "Tag > Add..." and "Tag > Remove..." commands to bulk assign or remove tags from selected drafts. Available both in File menu and context menu of draft list.
- **New:** "Merge..." command to merge multiple selected drafts. Available both in File menu and context menu of draft list.
- **New:** Rename and Delete tag commands in context menu of tags in the filter list.
- **New:** "Correct spelling automatically" editor setting to better support automatic substitutions.
- **New:** Ability to assign global keyboard shortcut to the main Drafts window (in Preferences).
- **New:** Fenced code blocks (```) will be highlighted in monospace font in MultiMarkdown and GitHub Markdown syntaxes.

#### Other Fixes and Changes

- **Change:** Reorganized flag menu items in File menu and added support for using them on multiple selections in list.
- **Fix:** Disabling "Open main window on launch" preference was not working properly.
- **Fix:** Sync sometime would not fail to properly update other devices when a draft was move archived/trashed.
- **Fix:** Appending to draft via capture window would not update the draft in the main window editor if it was loaded.
- **Fix:** Issue selecting draft in draft list after "new draft after" timeout expired.

For complete details and change history, please visit https://getdrafts.com/changelog-mac