{"_id":"@bonio-tw/canvg","_rev":"8-02d9ee712f80084527f0c037b2af9df5","name":"@bonio-tw/canvg","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@bonio-tw/canvg","version":"0.0.1","keywords":["javascript","client","browser","svg","canvas"],"author":{"name":"Gabe Lerner & BoniO TW"},"license":"MIT","_id":"@bonio-tw/canvg@0.0.1","maintainers":[{"name":"trista.lin","email":"trista.lin@bonio.com.tw"},{"name":"chester4096","email":"chester4096@gmail.com"},{"name":"amyhuang","email":"amy.huang@bonio.com.tw"},{"name":"jamliao","email":"jam.liao@bonio.com.tw"},{"name":"jeff.yeh","email":"jeff.yeh@bonio.com.tw"}],"homepage":"https://github.com/canvg/canvg#readme","bugs":{"url":"https://github.com/canvg/canvg/issues"},"dist":{"shasum":"7d975f9a078356eeb3069bc57bd9f8b19f9cdbb0","tarball":"https://registry.npmjs.org/@bonio-tw/canvg/-/canvg-0.0.1.tgz","fileCount":169,"integrity":"sha512-uDKCkyRfg79hnN6DRzF9GCy3K6Pzwo6WNhsW2bBonfRkZpk4/uq3LepvNpEpnVNGgq4pKP2T3uJZguXGL72Bzg==","signatures":[{"sig":"MEQCIA2RzIH4D6mIuPEV0ldfwCQNZCLhB13yNHQ5z9b/XJOoAiAfDycpazbS7ijXfKbFZKsxLJmcmjlK48BbOtK+dw7ktA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1294526},"main":"./src/index.ts","type":"module","authors":[{"name":"Gabe Lerner","email":"gabelerner@gmail.com"},{"name":"Brett Zamir"},{"url":"https://twitter.com/dangreen58","name":"Dan Green"},{"name":"BoniO TW"}],"engines":{"node":">=12.0.0"},"gitHead":"04b23f642ca073d3bd68ff587c60adf16cb91221","scripts":{"jest":"cross-env NODE_ENV=test jest -c jest.config.json","lint":"eslint 'rollup.config.js' 'types/**/*.ts' 'test/**/*.{js,ts}' 'src/**/*.ts'","test":"pnpm test:base","build":"run -p [ rollup -c ] emitDeclarations","clear":"del ./package ./dist ./coverage","start":"NODE_ENV=development rollup -c --watch & node --loader ts-node/esm test/common/server.ts","commit":"cz","release":"run bumpVersion [ git push origin master --tags ] createGithubRelease","test:base":"run -p lint [ jest test/util test/canvg ]","test:node":"pnpm jest test/node","test:size":"size-limit","build:demo":"./scripts/buildDemo.sh","start:node":"ts-node -P ./tsconfig.dev.json test/node/index.ts","bumpVersion":"standard-version","postpublish":"pnpm clear:package","test:browser":"pnpm jest test/browser","clear:package":"del ./package","prepublishOnly":"run test build clear:package clean-publish","test:offscreen":"pnpm jest test/offscreen","updateGitHooks":"simple-git-hooks","emitDeclarations":"tsc --emitDeclarationOnly","createGithubRelease":"simple-github-release"},"_npmUser":{"name":"amyhuang","email":"amy.huang@bonio.com.tw"},"repository":{"url":"git+https://github.com/canvg/canvg.git","type":"git"},"_npmVersion":"9.6.7","description":"JavaScript SVG parser and renderer on Canvas.","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"raf":"^3.4.1","rgbcolor":"^1.0.1","@types/raf":"^3.4.0","svg-pathdata":"^6.0.3","stackblur-canvas":"^2.0.0","@types/offscreencanvas":"^2019.6.4"},"publishConfig":{"main":"./dist/index.cjs","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{"import":"./dist/index.js","require":"./dist/index.cjs"},"directory":"package"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^27.2.5","canvas":"^2.1.0","eslint":"^8.0.0","rollup":"^2.67.1","xmldom":"^0.6.0","del-cli":"^4.0.1","ts-node":"^10.5.0","@swc/core":"^1.2.136","@swc/jest":"^0.2.17","cross-env":"^7.0.0","puppeteer":"^13.0.0","commitizen":"^4.2.4","node-fetch":"^2.6.0","size-limit":"^7.0.8","typescript":"^4.5.5","@babel/core":"^7.6.4","@babel/node":"^7.6.3","@types/jest":"^27.0.2","@types/node":"^17.0.16","http-server":"^14.0.0","jest-circus":"^27.2.5","nano-staged":"^0.8.0","@swc/helpers":"^0.3.2","browserslist":"^4.19.1","@types/xmldom":"^0.1.29","clean-publish":"^4.0.0","tsconfig-paths":"^3.8.0","@commitlint/cli":"^16.1.0","@trigen/scripts":"^8.0.0-alpha.9","@types/puppeteer":"^5.4.2","simple-git-hooks":"^2.7.0","standard-version":"^9.3.2","@types/node-fetch":"^2.5.12","rollup-plugin-swc":"^0.2.1","jest-image-snapshot":"^4.3.0","@trigen/babel-preset":"^8.0.0-alpha.5","@trigen/eslint-config":"^8.0.0-alpha.14","simple-github-release":"^1.0.0","@rollup/plugin-replace":"^4.0.0","@rollup/plugin-commonjs":"^21.0.1","@commitlint/cz-commitlint":"^16.1.0","@rollup/plugin-node-resolve":"^13.0.5","@trigen/browserslist-config":"^8.0.0-alpha.2","@size-limit/preset-small-lib":"^7.0.8","@commitlint/config-conventional":"^16.0.0"},"_npmOperationalInternal":{"tmp":"tmp/canvg_0.0.1_1708064863340_0.8605013910215262","host":"s3://npm-registry-packages"}},"0.0.2":{"name":"@bonio-tw/canvg","version":"0.0.2","keywords":["javascript","client","browser","svg","canvas"],"license":"MIT","_id":"@bonio-tw/canvg@0.0.2","maintainers":[{"name":"chester4096","email":"chester4096@gmail.com"},{"name":"amyhuang","email":"amy.huang@bonio.com.tw"},{"name":"jeff.yeh","email":"jeff.yeh@bonio.com.tw"},{"name":"trista.lin","email":"trista.lin@bonio.com.tw"},{"name":"elenachien","email":"terrisa1993@gmail.com"}],"homepage":"https://github.com/BoniO-Taiwan/canvg#readme","bugs":{"url":"https://github.com/BoniO-Taiwan/canvg/issues"},"raw":"lib/index.babel.js","umd":"lib/umd.js","dist":{"shasum":"83a8f6d168bc43807cbbf3001c51a86bbf0b034d","tarball":"https://registry.npmjs.org/@bonio-tw/canvg/-/canvg-0.0.2.tgz","fileCount":171,"integrity":"sha512-vKUbieuGkVA2FcpqnN2Kb/UGSfroNHN1iYW0di9M3spLOHfsNNlf4eORcuav6j3fGevdhzlCd6KBme1PP5pCfw==","signatures":[{"sig":"MEUCIAv1WAP3EnXi7aAgnv3Vtw5zmTPjTq0cr7hUZYkWFoaYAiEA4yLtxELQDW+dvYhrmjbdhjtZl2Q3MkmHBECBl5C+0SU=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1365539},"main":"lib/index.cjs","type":"module","types":"lib/index.d.ts","module":"lib/index.es.js","authors":[{"name":"Gabe Lerner","email":"gabelerner@gmail.com"},{"name":"Brett Zamir"},{"url":"https://twitter.com/dangreen58","name":"Dan Green"},{"name":"BoniO TW"}],"engines":{"node":">=10.0.0"},"exports":{"import":"./lib/index.es.js","require":"./lib/index.cjs"},"gitHead":"d09489af28b9f9031dd24c94558192c23170887f","scripts":{"jest":"cross-env NODE_ENV=test jest -c jest.config.json","lint":"eslint --cache 'rollup.config.js' 'src/**/*.ts' 'test/**/*.{js,ts}'","test":"yarn typecheck && yarn lint && yarn jest && yarn build && yarn checkSize","build":"cross-env NODE_ENV=production rollup -c","start":"ts-node -P ./tsconfig.dev.json test/common/server.ts","checkSize":"size-limit","typecheck":"tsc --noEmit --pretty --skipLibCheck","build:docs":"./scripts/buildDocs.sh","jest:debug":"cross-env NODE_ENV=test node --inspect node_modules/.bin/jest --watch --no-cache --runInBand -c jest.config.json","start:node":"ts-node -P ./tsconfig.dev.json -T test/node/index.ts","cleanPublish":"yarn test && clean-publish"},"_npmUser":{"name":"elenachien","email":"terrisa1993@gmail.com"},"repository":{"url":"git+https://github.com/BoniO-Taiwan/canvg.git","type":"git"},"_npmVersion":"6.14.13","description":"JavaScript SVG parser and renderer on Canvas.","directories":{},"sideEffects":false,"_nodeVersion":"14.17.2","dependencies":{"raf":"^3.4.1","core-js":"^3.8.3","rgbcolor":"^1.0.1","@types/raf":"^3.4.0","svg-pathdata":"^6.0.3","@babel/runtime":"^7.12.5","stackblur-canvas":"^2.0.0","regenerator-runtime":"^0.13.7"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^27.2.5","husky":"^4.0.9","canvas":"^2.1.0","eslint":"^7.0.0","rollup":"^2.10.5","xmldom":"^0.6.0","typedoc":"^0.20.16","cross-env":"^7.0.0","puppeteer":"^10.4.0","@babel/cli":"^7.6.4","babel-jest":"^27.2.5","node-fetch":"^2.6.0","size-limit":"^4.4.0","typescript":"3.9.7","@babel/core":"^7.6.4","@babel/node":"^7.6.3","@types/jest":"^27.0.2","http-server":"^0.12.0","jest-circus":"^27.2.5","lint-staged":"^10.0.2","ts-node-dev":"^1.0.0-pre.39","@types/xmldom":"^0.1.29","clean-publish":"^3.4.1","tsconfig-paths":"^3.8.0","builtin-modules":"*","@types/puppeteer":"^5.4.2","@types/node-fetch":"^3.0.3","jest-image-snapshot":"^4.3.0","@rollup/plugin-babel":"^5.0.0","@trigen/babel-preset":"^7.0.2","rollup-plugin-terser":"^7.0.2","@rollup/plugin-eslint":"^8.0.1","@trigen/eslint-config":"^7.0.6","@rollup/plugin-replace":"^3.0.0","@rollup/plugin-commonjs":"^18.0.0","rollup-plugin-typescript2":"^0.30.0","rollup-plugin-node-globals":"^1.4.0","@rollup/plugin-node-resolve":"^13.0.5","@trigen/browserslist-config":"^7.0.2","@size-limit/preset-small-lib":"^4.4.0"},"_npmOperationalInternal":{"tmp":"tmp/canvg_0.0.2_1733301143578_0.9410926058186555","host":"s3://npm-registry-packages"}}},"time":{"created":"2024-02-16T06:27:43.022Z","modified":"2026-02-09T01:59:16.317Z","0.0.1":"2024-02-16T06:27:43.593Z","0.0.2":"2024-12-04T08:32:23.864Z"},"bugs":{"url":"https://github.com/BoniO-Taiwan/canvg/issues"},"license":"MIT","homepage":"https://github.com/BoniO-Taiwan/canvg#readme","keywords":["javascript","client","browser","svg","canvas"],"repository":{"url":"git+https://github.com/BoniO-Taiwan/canvg.git","type":"git"},"description":"JavaScript SVG parser and renderer on Canvas.","maintainers":[{"email":"chester4096@gmail.com","name":"chester4096"},{"email":"jeff.yeh@bonio.com.tw","name":"jeff.yeh"},{"email":"terrisa1993@gmail.com","name":"elenachien"}],"readme":"# canvg\n\n[![NPM version][npm]][npm-url]\n[![Dependencies status][deps]][deps-url]\n[![Build status][build]][build-url]\n[![Coverage status][coverage]][coverage-url]\n[![Dependabot badge][dependabot]][dependabot-url]\n[![Documentation badge][documentation]][documentation-url]\n\n[npm]: https://img.shields.io/npm/v/canvg.svg\n[npm-url]: https://npmjs.com/package/canvg\n\n[deps]: https://david-dm.org/canvg/canvg.svg\n[deps-url]: https://david-dm.org/canvg/canvg\n\n[build]: https://img.shields.io/github/workflow/status/canvg/canvg/CI.svg\n[build-url]: https://github.com/canvg/canvg/actions\n\n[coverage]: https://img.shields.io/coveralls/canvg/canvg.svg\n[coverage-url]: https://coveralls.io/r/canvg/canvg\n\n[dependabot]: https://api.dependabot.com/badges/status?host=github&repo=canvg/canvg\n[dependabot-url]: https://dependabot.com/\n\n[documentation]: https://img.shields.io/badge/API-Documentation-2b7489.svg\n[documentation-url]: https://canvg.github.io/canvg\n\nJavaScript SVG parser and renderer on Canvas. It takes the URL to the SVG file or the text of the SVG file, parses it in JavaScript and renders the result on Canvas.\n\n[Demo](https://canvg.github.io/canvg/demo/index.html)\n\n[Playground](https://jsfiddle.net/0q1vrjxk/)\n\n## Install\n\n```sh\nnpm i canvg\n# or\nyarn add canvg\n```\n\n## Usage\n\nBasic module exports:\n\n```js\nexport default Canvg;\nexport {\n    presets\n};\n```\n\n[Description of all exports you can find in Documentation.](https://canvg.github.io/canvg/index.html)\n\n### Example\n\n```js\nimport Canvg from 'canvg';\n\nlet v = null;\n\nwindow.onload = async () => {\n    const canvas = document.querySelector('canvas');\n    const ctx = canvas.getContext('2d');\n    \n    v = await Canvg.from(ctx, './svgs/1.svg');\n\n    // Start SVG rendering with animations and mouse handling.\n    v.start();\n};\n\nwindow.onbeforeunload = () => {\n    v.stop();\n};\n```\n\n<details>\n    <summary>\n        <b>OffscreenCanvas</b>\n    </summary>\n\n```js\nimport Canvg, {\n    presets\n} from 'canvg';\n\nself.onmessage = async (event) => {\n    const {\n        width,\n        height,\n        svg\n    } = event.data;\n    const canvas = new OffscreenCanvas(width, height);\n    const ctx = canvas.getContext('2d');\n    const v = await Canvg.from(ctx, svg, presets.offscreen());\n\n    // Render only first frame, ignoring animations and mouse.\n    await v.render();\n\n    const blob = await canvas.convertToBlob();\n    const pngUrl = URL.createObjectURL(blob);\n\n    self.postMessage({\n        pngUrl\n    });\n};\n```\n\n[`OffscreenCanvas` browsers compatibility.](https://caniuse.com/offscreencanvas)\n\n</details>\n\n<details>\n    <summary>\n        <b>NodeJS</b>\n    </summary>\n\n```js\nimport {\n    promises as fs\n} from 'fs';\nimport {\n    DOMParser\n} from 'xmldom';\nimport * as canvas from 'canvas';\nimport fetch from 'node-fetch';\nimport Canvg, {\n    presets\n} from 'canvg';\n\nconst preset = presets.node({\n    DOMParser,\n    canvas,\n    fetch\n});\n\n(async (output, input) => {\n    const svg = await fs.readFile(input, 'utf8');\n    const canvas = preset.createCanvas(800, 600);\n    const ctx = canvas.getContext('2d');\n    const v = Canvg.fromString(ctx, svg, preset);\n\n    // Render only first frame, ignoring animations.\n    await v.render();\n\n    const png = canvas.toBuffer();\n\n    await fs.writeFile(output, png);\n\n})(\n    process.argv.pop(),\n    process.argv.pop()\n);\n```\n\n</details>\n\n<details>\n    <summary>\n        <b>Resize</b>\n    </summary>\n\n```js\nimport Canvg, {\n    presets\n} from 'canvg';\n\nself.onmessage = async (event) => {\n    const {\n        width,\n        height,\n        svg\n    } = event.data;\n    const canvas = new OffscreenCanvas(width, height);\n    const ctx = canvas.getContext('2d');\n    const v = await Canvg.from(ctx, svg, presets.offscreen());\n\n    /**\n     * Resize SVG to fit in given size.\n     * @param width\n     * @param height\n     * @param preserveAspectRatio\n     */\n    v.resize(width, height, 'xMidYMid meet');\n\n    // Render only first frame, ignoring animations and mouse.\n    await v.render();\n\n    const blob = await canvas.convertToBlob();\n    const pngUrl = URL.createObjectURL(blob);\n\n    self.postMessage({\n        pngUrl\n    });\n};\n```\n\n</details>\n\n<details>\n    <summary>\n        <b>Browser</b>\n    </summary>\n\n```html\n<script type=\"text/javascript\" src=\"https://unpkg.com/canvg@3.0.4/lib/umd.js\"></script>\n<script type=\"text/javascript\">\nwindow.onload = () => {\n    const canvas = document.querySelector('canvas');\n    const ctx = canvas.getContext('2d');\n    \n    v = canvg.Canvg.fromString(ctx, '<svg width=\"600\" height=\"600\"><text x=\"50\" y=\"50\">Hello World!</text></svg>');\n\n    // Start SVG rendering with animations and mouse handling.\n    v.start();\n\n};\n</script>\n<canvas />\n```\n\n</details>\n\n### Options\n\nThe third parameter of `new Canvg(...)`, `Canvg.from(...)` and `Canvg.fromString(...)` is options:\n\n```ts\ninterface IOptions {\n    /**\n     * WHATWG-compatible `fetch` function.\n     */\n    fetch?: typeof fetch;\n    /**\n     * XML/HTML parser from string into DOM Document.\n     */\n    DOMParser?: typeof DOMParser;\n    /**\n     * Window object.\n     */\n    window?: Window;\n    /**\n     * Whether enable the redraw.\n     */\n    enableRedraw?: boolean;\n    /**\n     * Ignore mouse events.\n     */\n    ignoreMouse?: boolean;\n    /**\n     * Ignore animations.\n     */\n    ignoreAnimation?: boolean;\n    /**\n     * Does not try to resize canvas.\n     */\n    ignoreDimensions?: boolean;\n    /**\n     * Does not clear canvas.\n     */\n    ignoreClear?: boolean;\n    /**\n     * Scales horizontally to width.\n     */\n    scaleWidth?: number;\n    /**\n     * Scales vertically to height.\n     */\n    scaleHeight?: number;\n    /**\n     * Draws at a x offset.\n     */\n    offsetX?: number;\n    /**\n     * Draws at a y offset.\n     */\n    offsetY?: number;\n    /**\n     * Will call the function on every frame, if it returns true, will redraw.\n     */\n    forceRedraw?(): boolean;\n    /**\n     * Default `rem` size.\n     */\n    rootEmSize?: number;\n    /**\n     * Default `em` size.\n     */\n    emSize?: number;\n    /**\n     * Function to create new canvas.\n     */\n    createCanvas?: (width: number, height: number) => HTMLCanvasElement | OffscreenCanvas;\n    /**\n     * Function to create new image.\n     */\n    createImage?: (src: string, anonymousCrossOrigin?: boolean) => Promise<CanvasImageSource>;\n    /**\n     * Load images anonymously.\n     */\n    anonymousCrossOrigin?: boolean;\n}\n```\n\n#### Options presets\n\nThere are two options presets:\n\n- `presets.offscreen()`: options for [`OffscreenCanvas`](https://developer.mozilla.org/en-US/docs/Web/API/OffscreenCanvas);\n- `presets.node({ DOMParser, canvas, fetch })`: options for NodeJS with [`node-canvas`](https://github.com/Automattic/node-canvas).\n\n## What's implemented?\n\nThe end goal is everything from the [SVG spec](http://www.w3.org/TR/SVG/). The majority of the rendering and animation is working. If you would like to see a feature implemented, don't hesitate to add it to the issues list, or better is to create pull request 😎\n","readmeFilename":"README.md"}