paper 0.13.0 → 0.15.0

package/examples/Scripts/AreaText.html

@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>Area Text</title>
+    <link rel="stylesheet" href="../css/style.css">
+    <script type="text/javascript" src="../../dist/paper-full.js"></script>
+    <script type="text/paperscript" canvas="canvas">
+        var words = 'Text flows inside an area, line by line, broken where '
+                + 'the words no longer fit, or at their soft hy\u00adphens, '
+                + 'and on into the next col\u00adumn. ';
+        // Two justified columns in a rectangle:
+        var text = new AreaText(new Rectangle(40, 40, 420, 260));
+        text.columns = 2;
+        text.gutter = 20;
+        text.content = words + words + words + '\n' + words + words + words
+                + words + words + words + words;
+        text.fontFamily = 'Georgia';
+        text.fontSize = 15;
+        text.justification = 'justify';
+        text.paragraphs[1].fillColor = '#c04';
+
+        // A circle, linked to the rectangle, so the story flows on into it:
+        var circle = new AreaText(new Path.Circle({
+            center: [640, 200],
+            radius: 140
+        }));
+        circle.fontFamily = 'Georgia';
+        circle.fontSize = 15;
+        circle.justification = 'center';
+        text.link(circle);
+
+        // A heading with balanced lines, in an area as high as they need:
+        var heading = new AreaText(new Rectangle(40, 340, 420, 0));
+        heading.content = 'A heading whose lines are balanced, so the last '
+                + 'one is not left alone';
+        heading.fontFamily = 'Georgia';
+        heading.fontSize = 28;
+        heading.lineWrap = 'balance';
+        heading.fitHeight();
+
+        // Show the guides, which the text items don't draw:
+        var guides = new Group([heading.textPath.clone(),
+                text.textPath.clone(), circle.textPath.clone()]);
+        guides.strokeColor = '#ddd';
+        guides.sendToBack();
+
+        // A circle above the columns, which pushes their text aside, and
+        // follows the mouse:
+        var wrap = new Path.Circle({
+            center: [250, 170],
+            radius: 50,
+            fillColor: '#048',
+            textWrap: { offset: 8 }
+        });
+
+        function onMouseMove(event) {
+            wrap.position = event.point;
+        }
+    </script>
+</head>
+<body>
+    <canvas id="canvas" resize></canvas>
+</body>
+</html>

package/examples/Scripts/PathText.html

@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>Path Text</title>
+    <link rel="stylesheet" href="../css/style.css">
+    <script type="text/javascript" src="../../dist/paper-full.js"></script>
+    <script type="text/paperscript" canvas="canvas">
+        // Text along a wave, which the mouse reshapes:
+        var path = new Path({
+            segments: [[60, 200], [260, 120], [460, 280], [660, 200]]
+        });
+        path.smooth();
+        var text = new PathText(path);
+        text.content = 'Text runs along a path, each letter turned to where it '
+                + 'sits, and what doesn\'t fit flows on into the next one.';
+        text.fontFamily = 'Georgia';
+        text.fontSize = 22;
+        text.words.forEach(function(word, i) {
+            word.fillColor = i % 2 ? '#c04' : '#048';
+        });
+
+        // A second text item along a circle, linked to the first, so the
+        // story flows on into it:
+        var circle = new PathText(new Path.Circle({
+            center: [360, 420],
+            radius: 90
+        }));
+        circle.fontFamily = 'Georgia';
+        circle.fontSize = 22;
+        text.link(circle);
+
+        // Show the guides, which the text items don't draw:
+        var guides = new Group([path.clone(), circle.textPath.clone()]);
+        guides.strokeColor = '#ddd';
+        guides.sendToBack();
+
+        function onMouseMove(event) {
+            path.segments[1].point.y = event.point.y;
+            path.smooth();
+            guides.firstChild.segments = path.segments;
+        }
+    </script>
+</head>
+<body>
+    <canvas id="canvas" resize></canvas>
+</body>
+</html>

package/examples/Scripts/TextRanges.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>Text Ranges</title>
+    <link rel="stylesheet" href="../css/style.css">
+    <script type="text/javascript" src="../../dist/paper-full.js"></script>
+    <script type="text/paperscript" canvas="canvas">
+        var text = new PointText({
+            point: [400, 80],
+            content: 'Every word its own size\nand every letter its own color\n'
+                    + 'Right justified, with space before, and a note1',
+            fontFamily: 'Georgia',
+            fontSize: 20
+        });
+
+        var paragraphs = text.paragraphs;
+
+        // Walk the words of the first paragraph and restyle them:
+        paragraphs[0].words.forEach(function(word) {
+            word.fontSize = 14 + word.content.length * 4;
+        });
+
+        // Walk the letters of the second paragraph:
+        paragraphs[1].letters.forEach(function(letter, i) {
+            letter.fillColor = { hue: i * 12, saturation: 0.8,
+                    brightness: 0.8 };
+        });
+
+        // Paragraph properties apply to whole paragraphs:
+        var last = paragraphs[2];
+        last.justification = 'right';
+        last.spaceBefore = 20;
+        last.fontStyle = 'italic';
+        text.range(last.start, last.start + 5).underline = true;
+
+        // Tracking and superscripts on ranges:
+        text.words[1].letterTracking = 300;
+        var end = text.content.length;
+        text.range(end - 1, end).baselinePosition = 'superscript';
+
+        var bounds = new Path.Rectangle({
+            rectangle: text.bounds,
+            strokeColor: '#ddd'
+        });
+    </script>
+</head>
+<body>
+    <canvas id="canvas" resize></canvas>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paper",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "The Swiss Army Knife of Vector Graphics Scripting",
   "license": "MIT",
   "homepage": "http://paperjs.org",
@@ -26,7 +26,9 @@
     "jshint": "gulp jshint",
     "test": "gulp test",
     "test:browser": "gulp test:browser",
-    "test:node": "gulp test:node"
+    "test:chrome": "gulp test:chrome",
+    "test:node": "gulp test:node",
+    "prepare": "husky"
   },
   "files": [
     "AUTHORS.md",
@@ -42,12 +44,6 @@
   "engines": {
     "node": ">=8.0.0"
   },
-  "husky": {
-    "hooks": {
-      "pre-commit": "yarn jshint --ensure-branch develop",
-      "pre-push": "yarn test --ensure-branch develop"
-    }
-  },
   "browser": {
     "./dist/node/extend.js": false,
     "./dist/node/self.js": false,
@@ -59,6 +55,7 @@
   },
   "devDependencies": {
     "acorn": "~0.5.0",
+    "acorn-latest": "npm:acorn@8.15.0",
     "ansi-colors": "^4.1.3",
     "canvas": "^3.2.3",
     "del": "^5.1.0",
@@ -78,14 +75,14 @@
     "gulp-webserver": "^0.9.1",
     "gulp-whitespace": "^0.1.0",
     "gulp-zip": "^5.1.0",
-    "husky": "^4.3.8",
+    "husky": "^9.1.7",
     "jsdom": "^28.1.0",
     "jshint": "^2.13.6",
     "jshint-summary": "^0.4.0",
     "merge-stream": "^2.0.0",
     "minimist": "^1.2.8",
     "mustache": "^4.2.0",
-    "prepro": "^2.4.0",
+    "prepro": "^2.5.0",
     "qunitjs": "^1.23.1",
     "require-dir": "^1.2.0",
     "resemblejs": "^3.2.5",
@@ -93,7 +90,7 @@
     "source-map-support": "^0.5.21",
     "stats.js": "^0.17.0",
     "straps": "^3.0.1",
-    "typescript": "^3.9.10"
+    "typescript": "^5.9.3"
   },
   "keywords": [
     "vector",