paper 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # Change Log
 
+## `0.17.0`
+
+### Added
+
+- Add `PathItem#offset(distance, options)`, which grows, shrinks or offsets
+  paths and compound paths with miter, round or bevel corners (#371).
+- Add `PathItem#outline(options)`, which turns the stroke of a path item into a
+  filled path item, with its joins, caps and dashes (#371).
+- Add `PathItem#dash(options)`, which cuts a stroke into its dashes as the
+  canvas draws them, as a group of open paths.
+- Add stroke profiles, `Path#strokeProfile`: stops along a path that change
+  the width, aspect and angle of the pen that draws its stroke, see
+  `StrokeProfileStop`. Not yet supported: compound paths, `strokeScaling` off,
+  and `offset()`, boolean operations, `interpolate()` and SVG (#2505, #2506,
+  #2507).
+- Add live effects, `Item#effects`, which change what an item draws without
+  changing the item, starting with `offset` and `outline`. `Effect` defines new
+  ones, and `Item#previewBounds` measures what they draw.
+- Add pattern colors from a `PatternDefinition`, which tiles a raster or any
+  other item, for fills and strokes, also in SVG and JSON (#829).
+- Add `Color#aspect` for elliptical radial gradients, and transform gradients
+  exactly with their items, also when these scale unevenly or shear (#1744).
+- Add `Group#buffered`, which keeps a group's drawing in a canvas until the
+  group changes, for large groups that rarely do (#377).
+- Add `Item#onDraw` and `Item#onDrawSelection`, which draw beneath an item or
+  its selection, or replace them, also as class-level handlers such as
+  `Path.onDraw`.
+- Add `PathItem#arcAround(center, angle)` and `PathItem#arcTowards(to)`
+  (#1052).
+- Support `options` in `PathItem#simplify()`, with `tolerance` and a range of
+  segments through `from` and `to`, as in `PathItem#smooth()` (#2501).
+- Export and import the names and data of segments in SVG, as a
+  `data-paper-segments` attribute (#2398).
+- Add `Project#onActivate` and `Project#onDeactivate`, also as
+  `Project.onActivate` and `Project.onDeactivate` for all projects.
+- Pass the import attributes of `import … with { … }` in PaperScript on to the
+  loader in `options.load` of `PaperScript.execute()`.
+- Hosted projects, see `Project#host`:
+  - Share symbol and pattern definitions between items, referred to by their
+    keys in JSON, and let scripts create new ones.
+  - Load the pixels of rasters from the host on first access.
+  - Load items in full when they move into a project with another host.
+  - Call `Item#onDraw` and `Item#onDrawSelection`, through `Project#draw()`.
+
+### Changed
+
+- Run the library in strict mode, which makes `Path#getNearestPoint()` about
+  14% and `Item#hitTest()` about 6% faster. PaperScript still runs in sloppy
+  mode.
+- Draw items with opacity, blend modes or shadows about twice as fast (#377).
+- Make `PaperScope#project` an accessor, so that PaperScript's `project`
+  follows the active project, as `view` does.
+- Emit `deactivate` when the active project or tool is removed.
+- Write the definition of symbol items to JSON as `definition` instead of
+  `symbol`, which still loads.
+- Let hosted linked text that moves into a project with another host bring a
+  copy of its story along (#2462, #2463).
+
+### Fixed
+
+- Fix boolean operations that could lose areas or whole results, at straight
+  curves, near-coincident crossings, curves running back and forth along a
+  line, shallow crossings and merged vertices.
+- Measure curve lengths precisely near cusps, where `Curve#getLength()` and
+  `Path#getPointAt()` were off by up to 6%.
+- Find the nearest point on curves that cover a lot of ground between their
+  samples, in `#getNearestPoint()` and the methods using it.
+- Fix `PathItem#smooth()` with a negative `to` on closed paths, which threw.
+- Fix `PathItem#arcTo()` with tiny arcs, which missed their end point.
+- Keep the attributes of compound paths in `CompoundPath#reduce()` when a
+  single child is left.
+- Return `false` from `CompoundPath#simplify()` without children.
+- Keep the stripes of linear gradients across them when transforming them
+  unevenly (#1744).
+- Export the gradients of items that keep their matrix to SVG in the
+  coordinates of their elements (#2410).
+- Honor the `bounds` and `matrix` options of `Item#exportSVG()`.
+- Keep `Group#isolated` and `Group#buffered` in clones.
+- Keep the content of rasters when setting `Raster#size`.
+- Load `new Raster(source)` from a string where there is no document, as in
+  workers.
+- Draw the segments of selected paths again by default (#1899).
+- Count the duration of `Item#tween()` from the first frame.
+- PaperScript: compile `++` and `--` correctly wherever they appear, keep
+  keywords apart from replaced expressions in minified code, report the right
+  lines in stack traces on V8, and return an object from `compile()` for empty
+  code.
+- Hosted projects: leave items that moved away out of `Project#takeChanges()`,
+  and turn off `View#autoUpdate` when setting `Project#host`.
+- Let Angular's esbuild builder bundle Paper.js for browsers (#2035).
+
 ## `0.16.0`
 
 ### Added
@@ -33,6 +124,8 @@
   new text has defaults of its own, such as a black fill without a stroke.
 - Add `Point#values`, `Size#values` and `Rectangle#values`, which give their
   numbers as an array, as `Matrix#values` does.
+- Add `options.evaluate` to `PaperScript.execute()`, for hosts whose engine
+  doesn't name code from `Function()` in stack traces, such as JavaScriptCore.
 
 ### Changed
 
@@ -62,6 +155,8 @@
 - Hit-test the strokes of shapes as those of their paths, which `Shape` only
   approximated for ellipses and rounded corners, and for non-scaling strokes
   under non-uniform matrices (#2334).
+- Name PaperScript's url in stack traces also without source maps, and in the
+  location of its syntax errors.
 
 ## `0.15.0`