fabric 7.3.1 → 7.5.0-beta.1

package/package.json

@@ -2,7 +2,7 @@
   "name": "fabric",
   "description": "Object model for HTML5 canvas, and SVG-to-canvas parser. Backed by jsdom and node-canvas.",
   "homepage": "http://fabricjs.com/",
-  "version": "7.3.1",
+  "version": "7.5.0-beta.1",
   "author": "Juriy Zaytsev <kangax@gmail.com>",
   "contributors": [
     {
@@ -39,57 +39,40 @@
     "url": "https://github.com/fabricjs/fabric.js/issues"
   },
   "license": "MIT",
-  "scripts": {
-    "docs": "typedoc",
-    "cli": "node ./scripts/index.mjs",
-    "sandboxscript": "node ./scripts/sandbox.mjs",
-    "typecheck": "tsc -p ./tsconfig.build.json --noEmit && tsc -p ./tsconfig-extensions.json --noEmit",
-    "build": "npm run cli -- build",
-    "build:fast": "npm run build -- -f",
-    "dev": "npm run cli -- dev",
-    "start": "npm run sandboxscript -- start",
-    "export": "npm run cli -- website export",
-    "test:vitest": "vitest --run --project unit-node",
-    "test:vitest:chromium": "vitest --run --project unit-chromium",
-    "test:vitest:firefox": "vitest --run --project unit-firefox",
-    "test:vitest:all": "vitest --run",
-    "test:vitest:coverage": "vitest --run --coverage --project unit-node",
-    "test:vitest:coverage:watch": "npm run test:vitest --coverage=true",
-    "test:e2e": "npm run playwright:typecheck && playwright test --",
-    "playwright:typecheck": "tsc -p ./e2e/tsconfig.json --noEmit",
-    "sandbox": "npm run sandboxscript -- sandbox",
-    "local-server": "serve ./ -l tcp://localhost:8080",
-    "lint": "eslint src extensions --fix",
-    "prettier:check": "oxfmt --check .",
-    "prettier:write": "oxfmt .",
-    "prepare": "husky install"
-  },
+  "files": [
+    "dist",
+    "dist-extensions",
+    "extensions/README.MD",
+    "!extensions/**/*.ts"
+  ],
   "devDependencies": {
-    "@eslint/js": "^9.37.0",
-    "@playwright/test": "^1.58.2",
-    "@rollup/plugin-terser": "^1.0.0",
-    "@types/jsdom": "^21.1.7",
-    "@types/micromatch": "^4.0.10",
-    "@types/node": "^24.7.0",
-    "@vitest/browser-playwright": "4.1.3",
-    "@vitest/coverage-v8": "4.1.3",
-    "@vitest/ui": "4.1.3",
-    "commander": "^14.0.3",
-    "es-toolkit": "1.45.1",
-    "eslint-config-prettier": "^10.1.8",
-    "husky": "^9.1.7",
-    "inquirer": "^13.3.2",
-    "lint-staged": "^16.4.0",
-    "micromatch": "^4.0.8",
-    "oxfmt": "^0.42.0",
-    "ps-list": "^9.0.0",
-    "rolldown": "^1.0.0-rc.12",
-    "serve": "^14.2.6",
-    "tsc-files": "^1.1.4",
-    "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.0",
-    "vitest": "4.1.3",
-    "westures": "^1.1.1"
+    "@playwright/test": "1.64.1",
+    "@types/jsdom": "21.1.7",
+    "@types/node": "24.13.6",
+    "@vitest/browser-playwright": "5.0.5",
+    "@vitest/coverage-v8": "5.0.5",
+    "@vitest/ui": "5.0.5",
+    "commander": "15.0.0",
+    "es-toolkit": "1.52.0",
+    "fast-check": "4.10.2",
+    "husky": "9.1.7",
+    "oxfmt": "0.73.0",
+    "oxlint": "1.87.0",
+    "oxlint-tsgolint": "7.0.2004",
+    "picomatch": "4.0.7",
+    "rolldown": "1.2.9",
+    "typedoc": "0.28.20",
+    "typescript": "6.0.3",
+    "vitest": "5.0.5",
+    "westures": "1.1.1"
+  },
+  "dependencies": {
+    "@fabricjs/aligning-guidelines": "^7.5.0-beta.1",
+    "@fabricjs/browser": "^7.5.0-beta.1",
+    "@fabricjs/data-updaters": "^7.5.0-beta.1",
+    "@fabricjs/westures-integration": "^7.5.0-beta.1",
+    "@fabricjs/gradient-controls": "^7.5.0-beta.1",
+    "@fabricjs/cropping-controls": "^7.5.0-beta.1"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -111,7 +94,16 @@
       ]
     }
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/index.mjs",
+    "./dist/index.min.mjs",
+    "./dist/index.js",
+    "./dist/index.min.js",
+    "./dist/fabric.mjs",
+    "./dist/fabric.min.mjs",
+    "./dist/index.node.mjs",
+    "./dist/index.node.cjs"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -126,10 +118,10 @@
       "default": null
     },
     "./node": {
-      "node": "./dist/index.node.cjs",
       "types": "./dist/index.node.d.ts",
       "import": "./dist/index.node.mjs",
       "require": "./dist/index.node.cjs",
+      "node": "./dist/index.node.cjs",
       "default": "./dist/index.node.cjs"
     },
     "./extensions": {
@@ -141,12 +133,34 @@
     }
   },
   "optionalDependencies": {
-    "canvas": "^3.2.0",
-    "jsdom": "^26.1.0"
+    "@fabricjs/node": "^7.5.0-beta.1"
   },
-  "lint-staged": {
-    "*.{js,md,css,ts,tsx,jsx,json}": "eslint --fix",
-    "*.{js,css,md,ts,tsx,jsx,json}": "oxfmt --no-error-on-unmatched-pattern",
-    "**/*.ts !(**/*.spec.ts) !(**/*.test.ts) !(vitest*.ts)": "tsc-files --noEmit"
+  "scripts": {
+    "docs": "typedoc --tsconfig typedoc.config.json",
+    "cli": "node ./scripts/index.mjs",
+    "sandboxscript": "node ./scripts/sandbox.mjs",
+    "typecheck": "tsc -p ./tsconfig.build.json --noEmit && tsc -p ./tsconfig-extensions.json --noEmit && tsc -p ./tsconfig.packages.json --noEmit && pnpm run typecheck:spec",
+    "typecheck:spec": "tsc -p ./tsconfig.spec.json --noEmit --incremental --tsBuildInfoFile ./node_modules/.cache/tsc/spec.tsbuildinfo",
+    "build": "node ./scripts/index.mjs build",
+    "build:clean": "pnpm run clean:dist && pnpm run build",
+    "build:fast": "node ./scripts/index.mjs build -f",
+    "clean:dist": "node ./scripts/clean-dist.mjs",
+    "smoke:packages": "node ./scripts/package-smoke.mjs",
+    "dev": "node ./scripts/index.mjs dev",
+    "start": "node ./scripts/sandbox.mjs start",
+    "test:vitest": "vitest --run --project unit-node",
+    "test:vitest:chromium": "vitest --run --project unit-chromium",
+    "test:vitest:firefox": "vitest --run --project unit-firefox",
+    "test:vitest:all": "vitest --run",
+    "test:vitest:coverage": "vitest --run --coverage --project unit-node",
+    "test:vitest:coverage:watch": "pnpm run test:vitest --coverage=true",
+    "test:e2e": "pnpm run build && pnpm run playwright:typecheck && pnpm --dir packages/e2e run test",
+    "playwright:typecheck": "pnpm --dir packages/e2e run typecheck",
+    "sandbox": "node ./scripts/sandbox.mjs sandbox",
+    "lint": "oxlint extensions packages",
+    "lint:fix": "oxlint --fix extensions packages",
+    "prettier:check": "oxfmt --check .",
+    "prettier:write": "oxfmt .",
+    "web-dev": "pnpm run build && node ./scripts/index.mjs build -f -w & pnpm --dir packages/website run dev; kill $!"
   }
-}
+}

package/.agents/skills/fabricjs-open-pr/SKILL.md

@@ -1,134 +0,0 @@
----
-name: fabricjs-open-pr
-description: Use when opening a Fabric.js pull request. Generates a conventional-commit style PR title, writes a concise PR description, includes `close #<issue>` only when an issue is provided, updates CHANGELOG.md in `[next]` with `- <pr title> [#<prNum>](https://github.com/fabricjs/fabric.js/pull/<prNum>)`, predicts the next PR number before opening, and reconciles changelog if the actual PR number differs.
----
-
-# Fabric.js Open PR
-
-Use this skill when the user asks to open a PR for `fabricjs/fabric.js`.
-
-## Inputs
-
-Collect or infer:
-
-- Branch to open
-- Base branch (default `master`)
-- Issue number to close (optional)
-- Short summary of changes (for title/description)
-
-Issue-number handling:
-
-- If the thread already includes an issue number, reuse it and do not ask again.
-- If the user explicitly says there is no issue, do not ask for one and omit issue-closing text.
-- Otherwise, ask the user for the issue number before creating the PR body.
-
-## Title Rules
-
-Create a short meaningful title using conventional commits style:
-
-- Format: `<type>(<optional-scope>): <summary>`
-- Allowed common types: `feat`, `fix`, `docs`, `ci`, `test`, `refactor`, `chore`
-- Keep summary short and specific.
-- Use lowercase type and scope.
-
-Examples:
-
-- `ci(): fix coverage artifact download in comment workflow`
-- `fix(coverage): flatten playwright istanbul output`
-- `docs(changelog): align next entry format`
-
-## Required PR Body
-
-PR body must include:
-
-- One short description paragraph of what changed and why
-- A compact bullet list of key changes
-- Closing reference exactly `close #<issue-num>` only when an issue number is provided
-
-## Changelog Update (Mandatory)
-
-Before opening the PR, ensure `CHANGELOG.md` under `## [next]` contains one line in this style:
-
-`- <pr title> [#<predictedPrNum>](https://github.com/fabricjs/fabric.js/pull/<predictedPrNum>)`
-
-Rules:
-
-- Use the exact PR title text.
-- Insert near the top of the `[next]` list.
-- Keep existing formatting untouched.
-
-## Predict Next PR Number Before Opening
-
-From repo root, determine next issue/PR number:
-
-```bash
-latest_num=$(gh api repos/fabricjs/fabric.js/issues --paginate -F per_page=1 -F state=all --jq '.[0].number' | head -n1)
-predicted_pr_num=$((latest_num + 1))
-```
-
-Preferred faster command (usually enough):
-
-```bash
-latest_num=$(gh api repos/fabricjs/fabric.js/issues?state=all\&per_page=1 --jq '.[0].number')
-predicted_pr_num=$((latest_num + 1))
-```
-
-Use `predicted_pr_num` in the changelog line before creating PR.
-
-## Open PR Workflow
-
-1. Confirm branch has intended commits.
-2. Build PR title using conventional-commit style.
-3. Resolve issue reference from thread context using the issue-number handling rules above.
-4. If an issue number is provided, include `close #<issue-num>` in PR body; otherwise do not include issue-closing text.
-5. Before any commit or PR creation, run quality checks:
-
-```bash
-npm run lint
-npm run prettier:check
-```
-
-6. Sync with latest `master` before opening the PR:
-
-```bash
-git fetch origin master
-git merge origin/master
-```
-
-7. If merge conflicts exist, resolve them before continuing.
-8. Predict next PR number.
-9. Update `CHANGELOG.md` `[next]` line with predicted number and title.
-10. Commit and push changelog/title-related edits. Never use `--no-verify`; pre-commit hooks must run and pass.
-11. If hooks modify files or fail, stage fixes and recommit until hooks pass.
-12. Create PR with `gh pr create --base <base> --head <branch> --title "<title>" --body-file <file>`.
-13. Fetch actual PR number.
-14. If actual number differs from prediction:
-    - Update the changelog line to actual number/link.
-    - Commit and push the correction.
-    - Optionally update PR body with a short note if needed.
-
-## Existing PR Maintenance
-
-If the user asks to finish or unblock an existing Fabric.js PR:
-
-1. Fetch fresh `origin/master`.
-2. If the PR is behind base or blocked by merge conflicts, merge `origin/master` into the PR branch locally.
-3. If the conflict involves only `CHANGELOG.md`, resolve it locally as part of the merge instead of asking the user whether to do that.
-4. Push the merge commit to the PR branch.
-5. Only pause to ask the user if the conflict touches files beyond `CHANGELOG.md` or if the resolution is ambiguous.
-
-## Verification Checklist
-
-Before finishing, verify:
-
-- PR title follows conventional commit style and matches changelog text.
-- PR body includes description.
-- If an issue number is provided, PR body includes `close #<issue-num>`.
-- `npm run lint` passes.
-- `npm run prettier:check` passes.
-- Any commit made for this PR was created without `--no-verify` and pre-commit hooks passed.
-- Branch was synced with latest `master` before PR creation.
-- When maintaining an existing PR, `origin/master` was merged into the PR branch if that was enough to clear a `CHANGELOG.md`-only conflict.
-- `CHANGELOG.md` has exactly one new `[next]` line for this PR.
-- Link uses `https://github.com/fabricjs/fabric.js/pull/<prNum>`.
-- If prediction mismatched, changelog has been corrected and pushed.

package/.browserslistrc

@@ -1,8 +0,0 @@
-# Browsers that we support
-# Picked up for fabric 7.0 In April 2025 Browsers released jan 2021
-chrome >= 88
-safari >= 13
-firefox >= 85
-edge >= 88
-Opera >= 73
-not ie > 0

package/.editorconfig

@@ -1,12 +0,0 @@
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false

package/.gitattributes

@@ -1,2 +0,0 @@
-# https://stackoverflow.com/a/13264117/9068029
-CHANGELOG.md merge=union

package/.gitpod.yml

@@ -1,22 +0,0 @@
-# https://www.gitpod.io/docs/config-gitpod-file
-
-tasks:
-  - name: Build & Watch
-    init: npm install
-    command: npm run build -- -w -f
-
-  - name: Node
-    init: npm install
-    command: npm start node -- --no-watch
-
-  - name: Next.js
-    init: npm install
-    command: npm start next -- --no-watch
-
-  - name: Vanilla
-    init: npm install
-    command: npm start vanilla -- --no-watch
-
-  - name: Vue.js
-    init: gp sync-await deps
-    command: npm start vue -- --no-watch

package/.husky/pre-commit

@@ -1 +0,0 @@
-npx lint-staged

package/.nvmrc

@@ -1 +0,0 @@
-24

package/.oxfmtrc.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "./node_modules/oxfmt/configuration_schema.json",
-  "tabWidth": 2,
-  "singleQuote": true,
-  "printWidth": 80,
-  "sortPackageJson": false,
-  "ignorePatterns": [
-    ".codesandbox/",
-    ".DS_Store",
-    "*.iml",
-    "change-output.md",
-    "/.nyc_output/",
-    "/node_modules/",
-    "/npm-debug.log",
-    "before_commit",
-    "/coverage/",
-    ".idea/",
-    "/cli_output/",
-    "/scripts/cli_cache.json",
-    "**/dist/",
-    "**/dist-extensions/",
-    "/lib/",
-    "/test/",
-    "/website/",
-    ".next/",
-    ".parcel-cache/",
-    "/docs/",
-    "/e2e/test-results/",
-    "/e2e/test-report/",
-    "/e2e/tests/**/*-snapshots/*.json"
-  ]
-}

package/AGENTS.md

@@ -1,91 +0,0 @@
-# AGENTS.md instructions for /Users/andreabogazzi/develop/fabric.js
-
-This file defines how coding agents should operate in this repository.
-
-## Project
-
-- Repository: `fabricjs/fabric.js`
-- Language: TypeScript/JavaScript
-- Package manager: `npm`
-- Runtime: Node `>=20`
-- Main test stacks: `vitest` (unit) and `playwright` (e2e)
-
-## Repository Priorities
-
-- Keep changes focused and minimal.
-- Preserve existing architecture and naming style.
-- Avoid broad refactors unless explicitly requested.
-- Prefer fixing root causes over adding workarounds.
-
-## Setup
-
-Run from repo root:
-
-```bash
-npm i --include=dev
-```
-
-## Common Commands
-
-- Build: `npm run build`
-- Fast build: `npm run build:fast`
-- Typecheck: `npm run typecheck`
-- Lint: `npm run lint`
-- Format check: `npm run prettier:check`
-- Format write: `npm run prettier:write`
-- Unit tests (node): `npm run test:vitest`
-- Unit tests with coverage: `npm run test:vitest:coverage`
-- E2E tests: `npm run test:e2e`
-- E2E typecheck: `npm run playwright:typecheck`
-
-## Testing Expectations
-
-- Add or update tests for behavior changes.
-- Prefer targeted test runs while iterating, then run relevant full suites before finalizing.
-
-## Code Style
-
-- Follow existing project style and patterns.
-- Keep imports stable; do not reorder unless necessary.
-- Use concise comments only when code is not obvious.
-- Avoid unrelated formatting-only diffs in touched files.
-
-## PR and Changelog Workflow
-
-- Use clear, short PR titles.
-- Prefer conventional-commit style in titles when possible:
-  - `feat`, `fix`, `docs`, `ci`, `test`, `refactor`, `chore`
-- Add `close #<issue-num>` in PR body only when an issue number exists; if the user states there is no issue, omit it.
-- Ensure `CHANGELOG.md` (`## [next]`) is updated for notable changes.
-- Keep changelog entry style consistent with existing lines.
-
-## In-Repo Skills
-
-Agents should check and use repository skills when tasks match.
-
-Available skill:
-
-- `fabricjs-open-pr`
-  - Path: `.codex/skills/fabricjs-open-pr/SKILL.md`
-  - Use when opening PRs for this repository.
-  - Handles PR title/body quality, optional `close #<issue-num>`, changelog entry, and predicted PR number flow.
-
-## Skill Trigger Guidance
-
-Use the `fabricjs-open-pr` skill when any of these apply:
-
-- User asks to open/create a PR.
-- User asks to prepare PR metadata (title/body/changelog).
-- User asks to include issue-closing syntax like `close #123`.
-
-## Git Safety
-
-- Never discard user changes unless explicitly asked.
-- Do not use destructive git commands without explicit instruction.
-- Commit only files relevant to the requested task.
-
-## Communication
-
-- Be concise and factual.
-- Surface assumptions and blockers early.
-- When something cannot be verified locally, state that clearly.