@litecanvas/plugin-migrate 0.2.1 → 0.4.0

package/dist/dist.js

@@ -1,2 +1,2 @@
-(()=>{var o=(a,c="Assertion failed")=>{if(!a)throw new Error(c)};var _=(a,c,m,l,s,h,f,b)=>(o(isFinite(a),"colrect: 1st param must be a number"),o(isFinite(c),"colrect: 2nd param must be a number"),o(isFinite(m),"colrect: 3rd param must be a number"),o(isFinite(l),"colrect: 4th param must be a number"),o(isFinite(s),"colrect: 5th param must be a number"),o(isFinite(h),"colrect: 6th param must be a number"),o(isFinite(f),"colrect: 7th param must be a number"),o(isFinite(b),"colrect: 8th param must be a number"),a<s+f&&a+m>s&&c<h+b&&c+l>h);var x=(a,c,m,l,s,h)=>(o(isFinite(a),"colcirc: 1st param must be a number"),o(isFinite(c),"colcirc: 2nd param must be a number"),o(isFinite(m),"colcirc: 3rd param must be a number"),o(isFinite(l),"colcirc: 4th param must be a number"),o(isFinite(s),"colcirc: 5th param must be a number"),o(isFinite(h),"colcirc: 6th param must be a number"),(l-a)*(l-a)+(s-c)*(s-c)<=(m+h)*(m+h));var wt=2*Math.PI;var oe=Math.PI/2;var Z={warnings:!0};function v(a,c={}){if(c=Object.assign({},Z,c),a.stat(1))throw'Plugin Migrate should be loaded before the "init" event';let l=a.stat(0);function s(t,e,r=""){c.warnings&&console.warn(`[litecanvas/migrate] ${t} is removed. `+(e?`Use ${e} instead. `:"")+r)}function h(t){return s("seed()","rseed()"),t&&a.rseed(t),a.stat(9)}let f="";function b(t){s("textstyle()","the 5th param of text()"),f=t}let w=a.text;function g(t,e,r,i=3,p=f){w(t,e,r,i,p)}function E(t,e,r,i){s("print()","text()"),g(t,e,r,i)}function M(t,e){s("textmetrics()","ctx().measureText()");let r=a.ctx(),i=a.stat(10),p=a.stat(11);r.font=`${f||""} ${~~(e||i)}px ${p}`;let d=r.measureText(t);return d.height=d.actualBoundingBoxAscent+d.actualBoundingBoxDescent,d}function I(t,e,r,i){s("cliprect()","clip()");let p=a.ctx();p.beginPath(),p.rect(t,e,r,i),p.clip()}function A(t,e,r){s("clipcirc()","clip()");let i=a.ctx();i.beginPath(),i.arc(t,e,r,0,a.TWO_PI),i.clip()}function T(t){s("getcolor()","stat(5)");let e=stat(5);return e[~~t%e.length]}function P(t){s("blendmode()","ctx().globalCompositeOperation");let e=a.ctx();e.globalCompositeOperation=t}function R(t){s("clear()","cls()"),a.cls(t)}function C(t,e,r,i,p,d,D=!0){return s("transform()","ctx().setTransform() or ctx().transform()"),a.ctx()[D?"setTransform":"transform"](t,e,r,i,p,d)}function S(){return s("mousepos()","MX and MY"),[MX,MY]}function k(t){s("setfps()","framerate()"),a.framerate(t)}let n=a.def;function u(t,e){switch(t){case"W":case"WIDTH":n("W",e),n("WIDTH",e);break;case"H":case"HEIGHT":n("H",e),n("HEIGHT",e);break;case"T":case"ELAPSED":n("T",e),n("ELAPSED",e);break;case"CX":case"CENTERX":n("CX",e),n("CENTERX",e);break;case"CY":case"CENTERY":n("CY",e),n("CENTERY",e);break;case"MX":case"MOUSEX":n("MX",e),n("MOUSEX",e);break;case"MY":case"MOUSEY":n("MY",e),n("MOUSEY",e);break;default:n(t,e);break}}function L(t,e){s("setvar()","def()"),u(t,e)}a.listen("resized",y);function y(){u("CX",a.W/2),u("CY",a.H/2)}y(),u("CANVAS",a.canvas());function N(t,e){if(l.autoscale)throw"resize() don't works with autoscale enabled";s("resize()",null,"Avoid changing the canvas dimensions at runtime."),a.CANVAS.width=t,u("W",t),u("CX",t/2),a.CANVAS.height=e,u("H",e),u("CY",e/2),a.emit("resized",1)}for(let t of["W","H","T","CX","CY","MX","MY"])a[t]!=null&&u(t,a[t]);if(s("FPS","","but you can use our plugin to measure the fps: https://github.com/litecanvas/plugin-frame-rate-meter"),n("FPS",""),l.fps&&a.framerate(l.fps),l.background!=null){let t=a.listen("before:draw",()=>{let e=stat(5);a.canvas().style.background=e[~~l.background%e.length],t()})}function O(t){return s("path()","`new Path2D`","See https://developer.mozilla.org/en-US/docs/Web/API/Path2D"),new Path2D(t)}let z=a.fill;function F(t,e){if(e instanceof Path2D){s("fill(color, path)");let r=a.stat(5),i=a.ctx();i.fillStyle=r[~~t%r.length],a.ctx().fill(e)}else z(t)}let Y=a.stroke;function H(t,e){if(e instanceof Path2D){s("stroke(color, path)");let r=a.stat(5),i=a.ctx();i.strokeStyle=r[~~t%r.length],a.ctx().stroke(e)}else Y(t)}let W=a.clip;function B(t){s("clip(path)","clip(callback)","E.g: `clip((ctx) => ctx.rect(0, 0, 200, 200))`"),t instanceof Path2D?a.ctx().clip(t):W(t)}return l.antialias&&s('"antialias" option','"pixelart" option'),{def:u,seed:h,print:E,clear:R,setfps:k,setvar:L,textstyle:b,textmetrics:M,text:g,cliprect:I,clipcirc:A,blendmode:P,transform:C,getcolor:T,mousepos:S,resize:N,path:O,fill:F,stroke:H,clip:B,colrect:_,colcirc:x}}window.pluginMigrate=v;})();
+(()=>{var x=(s,c,h,m,n,r,b,f)=>s<n+b&&s+h>n&&c<r+f&&c+m>r;var _=(s,c,h,m,n,r)=>(m-s)*(m-s)+(n-c)*(n-c)<=(h+r)*(h+r);var At=2*Math.PI;var ge=Math.PI/2;var j={warnings:!0};function v(s,c={}){c=Object.assign({},j,c);let h=s.stat(1),m={def:u,seed:b,print:N,clear:T,setfps:S,setvar:R,textstyle:w,textmetrics:E,cliprect:M,clipcirc:I,blendmode:A,transform:k,getcolor:y,mousepos:P,resize:C,path:L,fill:Y,stroke:F,clip:X,paint:W,colrect:x,colcirc:_};if(h)throw'Plugin Migrate should be loaded before the "init" event';let n=s.stat(0);function r(t,e,a=""){c.warnings&&console.warn(`[litecanvas/migrate] ${t} is removed. `+(e?`Use ${e} instead. `:"")+a)}function b(t){return r("seed()","rseed()"),t&&s.rseed(t),s.stat(9)}let f="";function w(t){r("textstyle()","the 5th param of text()"),f=t}function N(t,e,a,i){r("print()","text()"),s.text(t,e,a,i)}function E(t,e){r("textmetrics()","ctx().measureText()");let a=s.ctx(),i=s.stat(10),l=s.stat(11);a.font=`${f||""} ${~~(e||i)}px ${l}`;let p=a.measureText(t);return p.height=p.actualBoundingBoxAscent+p.actualBoundingBoxDescent,p}function M(t,e,a,i){r("cliprect()","clip()");let l=s.ctx();l.beginPath(),l.rect(t,e,a,i),l.clip()}function I(t,e,a){r("clipcirc()","clip()");let i=s.ctx();i.beginPath(),i.arc(t,e,a,0,s.TWO_PI),i.clip()}function y(t){r("getcolor()","stat(5)");let e=stat(5);return e[~~t%e.length]}function A(t){r("blendmode()","ctx().globalCompositeOperation");let e=s.ctx();e.globalCompositeOperation=t}function T(t){r("clear()","cls()"),s.cls(t)}function k(t,e,a,i,l,p,B=!0){return r("transform()","ctx().setTransform() or ctx().transform()"),s.ctx()[B?"setTransform":"transform"](t,e,a,i,l,p)}function P(){return r("mousepos()","MX and MY"),[MX,MY]}function S(t){r("setfps()","framerate()"),s.framerate(t)}let o=s.def;function u(t,e){switch(t){case"W":case"WIDTH":o("W",e),o("WIDTH",e);break;case"H":case"HEIGHT":o("H",e),o("HEIGHT",e);break;case"T":case"ELAPSED":o("T",e),o("ELAPSED",e);break;case"CX":case"CENTERX":o("CX",e),o("CENTERX",e);break;case"CY":case"CENTERY":o("CY",e),o("CENTERY",e);break;case"MX":case"MOUSEX":o("MX",e),o("MOUSEX",e);break;case"MY":case"MOUSEY":o("MY",e),o("MOUSEY",e);break;default:o(t,e);break}}function R(t,e){r("setvar()","def()"),u(t,e)}s.listen("resized",g);function g(){u("CX",s.W/2),u("CY",s.H/2)}g(),u("CANVAS",s.canvas());function C(t,e){if(n.autoscale)throw"resize() don't works with autoscale enabled";r("resize()",null,"Avoid changing the canvas dimensions at runtime."),s.CANVAS.width=t,u("W",t),s.CANVAS.height=e,u("H",e),s.emit("resized",1)}for(let t of["W","H","T","CX","CY","MX","MY"])s[t]!=null&&u(t,s[t]);if(r("FPS","","but you can use our plugin to measure the fps: https://github.com/litecanvas/plugin-frame-rate-meter"),o("FPS",""),n.fps&&s.framerate(n.fps),n.background!=null){r('"background" option',"You must update your canvas CSS");let t=s.listen("before:draw",()=>{s.canvas().style.background=y(~~n.background),t()})}function L(t){return r("path()","`new Path2D()`","See https://developer.mozilla.org/en-US/docs/Web/API/Path2D"),new Path2D(t)}let z=s.fill;function Y(t,e){if(e instanceof Path2D){r("fill(color, path)");let a=s.stat(5),i=s.ctx();i.fillStyle=a[~~t%a.length],s.ctx().fill(e)}else z(t)}let O=s.stroke;function F(t,e){if(e instanceof Path2D){r("stroke(color, path)");let a=s.stat(5),i=s.ctx();i.strokeStyle=a[~~t%a.length],s.ctx().stroke(e)}else O(t)}let D=s.clip;function X(t){r("clip(path)","clip(callback)","E.g: `clip((ctx) => ctx.rect(0, 0, 200, 200))`"),t instanceof Path2D?s.ctx().clip(t):D(t)}n.antialias&&r('"antialias" option','"pixelart" option'),n.pixelart===!1&&r('"pixelart" option'),n.animate===!1&&r('"animate" option',"pause() in the of your draw()");let H=s.paint;function W(t,e,a,i){let l=a;return s.spr&&Array.isArray(a)&&(l=()=>{s.spr(0,0,a.join("").replace(/ /g,"."))}),H(t,e,l,i)}let d=s.spr;return d&&d.length===3&&(m.spr=function(t,e,a,i,l){Number.isFinite(a)&&a>0?(r("spr() width and height","spr(x, y, pixels)"),d(t,e,l)):d(t,e,a)}),m}window.pluginMigrate=v;})();
 /*! Migrate for litecanvas by Luiz Bills | MIT Licensed */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litecanvas/plugin-migrate",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Sometimes upgrading litecanvas to a new version can be a lot of work. This plugin makes this easier, by restoring the Litecanvas APIs that were removed in newer versions, and additionally shows warnings in the browser console when removed and/or deprecated APIs are used.",
   "author": "Luiz Bills <luizbills@pm.me>",
   "license": "MIT",
@@ -19,12 +19,12 @@
   ],
   "scripts": {
     "dev": "esbuild src/_web.js --bundle --watch --outfile=dist/dist.js --servedir=.",
-    "build": "esbuild src/_web.js --bundle --minify --outfile=dist/dist.js",
+    "build": "esbuild src/_web.js --drop-labels=DEV --bundle --minify --outfile=dist/dist.js",
     "prepare": "npm run build",
     "test": "ava --tap | tap-min"
   },
   "devDependencies": {
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.12",
     "@litecanvas/jsdom-extras": "^1.1.0",
     "@types/jsdom": "^21.1.7",
     "ava": "^6.4.1",

package/src/index.js

@@ -16,6 +16,33 @@ export default function plugin(engine, config = {}) {
   config = Object.assign({}, defaults, config)
   const initialized = engine.stat(1)
 
+  const replacements = {
+    def: _def,
+    seed,
+    print,
+    clear,
+    setfps,
+    setvar,
+    textstyle,
+    textmetrics,
+    cliprect,
+    clipcirc,
+    blendmode,
+    transform,
+    getcolor,
+    mousepos,
+    resize,
+    path,
+    fill,
+    stroke,
+    clip,
+    paint,
+
+    // restore collision utils
+    colrect,
+    colcirc,
+  }
+
   if (initialized) {
     throw 'Plugin Migrate should be loaded before the "init" event'
   }
@@ -46,14 +73,9 @@ export default function plugin(engine, config = {}) {
     _fontStyle = value
   }
 
-  const _core_text = engine.text
-  function _text(x, y, str, color = 3, style = _fontStyle) {
-    _core_text(x, y, str, color, style)
-  }
-
   function print(x, y, str, color) {
     warn("print()", "text()")
-    _text(x, y, str, color)
+    engine.text(x, y, str, color)
   }
 
   function textmetrics(text, size) {
@@ -184,13 +206,12 @@ export default function plugin(engine, config = {}) {
     }
 
     warn("resize()", null, "Avoid changing the canvas dimensions at runtime.")
+
     engine.CANVAS.width = width
     _def("W", width)
-    _def("CX", width / 2)
 
     engine.CANVAS.height = height
     _def("H", height)
-    _def("CY", height / 2)
 
     engine.emit("resized", 1)
   }
@@ -213,11 +234,10 @@ export default function plugin(engine, config = {}) {
   }
 
   // restore the "background" option
-  if (settings.background != null) {
+  if (null != settings.background) {
+    warn('"background" option', "You must update your canvas CSS")
     const removeThisListener = engine.listen("before:draw", () => {
-      const colors = stat(5)
-      engine.canvas().style.background =
-        colors[~~settings.background % colors.length]
+      engine.canvas().style.background = getcolor(~~settings.background)
       removeThisListener()
     })
   }
@@ -226,7 +246,7 @@ export default function plugin(engine, config = {}) {
   function path(arg) {
     warn(
       "path()",
-      "`new Path2D`",
+      "`new Path2D()`",
       "See https://developer.mozilla.org/en-US/docs/Web/API/Path2D"
     )
     return new Path2D(arg)
@@ -277,30 +297,36 @@ export default function plugin(engine, config = {}) {
     warn('"antialias" option', '"pixelart" option')
   }
 
-  return {
-    def: _def,
-    seed,
-    print,
-    clear,
-    setfps,
-    setvar,
-    textstyle,
-    textmetrics,
-    text: _text,
-    cliprect,
-    clipcirc,
-    blendmode,
-    transform,
-    getcolor,
-    mousepos,
-    resize,
-    path,
-    fill,
-    stroke,
-    clip,
+  if (false === settings.pixelart) {
+    warn('"pixelart" option')
+  }
 
-    // restore collision utils
-    colrect,
-    colcirc,
+  if (false === settings.animate) {
+    warn('"animate" option', "pause() in the of your draw()")
   }
+
+  const _core_paint = engine.paint
+  function paint(w, h, data, options) {
+    let cb = data
+    if (engine.spr && Array.isArray(data)) {
+      cb = () => {
+        engine.spr(0, 0, data.join("").replace(/ /g, "."))
+      }
+    }
+    return _core_paint(w, h, cb, options)
+  }
+
+  const _core_spr = engine.spr
+  if (_core_spr && _core_spr.length === 3) {
+    replacements.spr = function (x, y, w, h, pixels) {
+      if (Number.isFinite(w) && w > 0) {
+        warn("spr() width and height", "spr(x, y, pixels)")
+        _core_spr(x, y, pixels)
+      } else {
+        _core_spr(x, y, w)
+      }
+    }
+  }
+
+  return replacements
 }