fabric 7.4.0 → 7.5.0-beta.1

package/README.md

@@ -13,13 +13,12 @@ A **simple and powerful Javascript HTML5 canvas library**.
 
 Here is a section for recognition of companies or individuals that support fabricJS with a sponsorship
 
-   <a href="https://go.warp.dev/fabric">
-      <img alt="Warp sponsorship" width="300" src="https://github.com/warpdotdev/brand-assets/blob/main/Github/Sponsor/Warp-Github-LG-01.png">
+   <a href="https://www.atlascloud.ai/?utm_source=github&utm_medium=link&utm_campaign=fabric.js" >
+      <img alt="Atlascloud sponsorship" width="300" height="auto" src="https://www.atlascloud.ai/logo.svg" style="background-color: white;">
    </a>
 
-### [Warp, built for coding with multiple AI agents](https://go.warp.dev/fabric)
-
-[Available for MacOS, Linux, & Windows](https://go.warp.dev/fabric)<br>
+Atlas Cloud is a full-modal AI inference platform that gives developers a single AI API to access video generation, image generation, and LLM APIs. Instead of managing multiple vendor integrations, you connect once and get unified access to 300+ curated models across all modalities.
+Check out Atlas Cloud's new coding plan promotion for more budget-friendly API access：[https://www.atlascloud.ai/console/coding-plan](https://www.atlascloud.ai/console/coding-plan?utm_source=github&utm_medium=link&utm_campaign=fabric.js)
 
 </div>
 
@@ -49,14 +48,74 @@ Fabric.js does not use polyfills by default, or tries to keep it at minimum. the
 
 ## Installation
 
+For new applications, install the environment-specific package:
+
+```bash
+# Browser applications
+npm install @fabricjs/browser
+
+# Node.js applications
+npm install @fabricjs/node
+```
+
+The legacy `fabric` package remains supported for existing applications:
+
 ```bash
 $ npm install fabric --save
 # or use yarn
 $ yarn add fabric
 # or use pnpm
-$ pnpm install fabric
+$ pnpm add fabric
+```
+
+## Packages and migration
+
+| Package             | Role                                                                                                                            |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `fabric`            | Legacy compatibility facade. It re-exports `@fabricjs/browser`.                                                                 |
+| `@fabricjs/browser` | Preferred entrypoint for new browser applications.                                                                              |
+| `@fabricjs/node`    | Preferred entrypoint for new Node.js applications. It owns the Node-specific dependencies.                                      |
+| `@fabricjs/core`    | Shared, environment-neutral runtime used by the browser and Node packages. It is intended for advanced and shared dependencies. |
+| Extension packages  | Optional features imported individually, such as `@fabricjs/aligning-guidelines`.                                               |
+
+Existing imports continue to work:
+
+```js
+import { Canvas } from 'fabric';
+import { StaticCanvas } from 'fabric/node';
 ```
 
+New applications should prefer the explicit entrypoints:
+
+```js
+import { Canvas } from '@fabricjs/browser';
+import { StaticCanvas } from '@fabricjs/node';
+import { AligningGuidelines } from '@fabricjs/aligning-guidelines';
+```
+
+The `fabric` and `fabric/node` facades share the same class identities as
+their corresponding workspace packages. Keep `fabric` and every
+`@fabricjs/*` package on matching versions; mixing mismatched versions can
+load separate runtimes.
+
+`@fabricjs/core` has no Node-specific runtime dependencies, but it is not a
+DOM-free API. Advanced consumers using core APIs that touch DOM or canvas must
+provide a suitable environment implementation.
+
+### Legacy distribution files
+
+The ESM `fabric` and `fabric/node` entries are small compatibility facades over
+the workspace packages. The legacy standalone files remain available for
+existing usage:
+
+- `dist/index.js` and `dist/index.min.js` are full browser UMD builds from
+  `@fabricjs/browser`, for `<script>` tags and `require('fabric')`.
+- `dist/index.node.cjs` is the legacy CommonJS compatibility build for
+  `require('fabric/node')`.
+
+New ESM applications should continue to import `@fabricjs/browser` or
+`@fabricjs/node` directly.
+
 #### Browser
 
 [![cdnjs](https://img.shields.io/cdnjs/v/fabric.js.svg)][cdnjs]
@@ -68,7 +127,7 @@ See [browser modules][mdn_es6] for using es6 imports in the browser or use a ded
 
 We strongly recommend to run your applications only LTS versions of node.
 
-Said so the minimum supported version of node is 18.
+Said so the minimum supported version of node is 20.
 We bump up the minimum version of node with a Major release only when the dependencies force us to do so.
 
 Fabric.js depends on [node-canvas][node_canvas] for a canvas implementation (`HTMLCanvasElement` replacement) and [jsdom][jsdom] for a `window` implementation on node.
@@ -79,11 +138,17 @@ Follow these [instructions][node_canvas_install] to get `node-canvas` up and run
 ## Quick Start
 
 ```js
-// v6
-import { Canvas, Rect } from 'fabric'; // browser
-import { StaticCanvas, Rect } from 'fabric/node'; // node
+// Preferred entrypoints for new applications
+import { Canvas } from '@fabricjs/browser';
+import { StaticCanvas } from '@fabricjs/node';
+```
+
+```js
+// Supported compatibility entrypoints
+import { Canvas } from 'fabric';
+import { StaticCanvas } from 'fabric/node';
 
-// v5
+// v5 compatibility
 import { fabric } from 'fabric';
 ```
 

package/dist/fabric.min.mjs

@@ -1 +1 @@
-import{config as e}from"./src/config.min.mjs";import{getEnv as t,getFabricDocument as n,getFabricWindow as r,setEnv as ee}from"./src/env/index.min.mjs";import{cache as i}from"./src/cache.min.mjs";import{VERSION as a,iMatrix as o}from"./src/constants.min.mjs";import{classRegistry as s}from"./src/ClassRegistry.min.mjs";import{runningAnimations as c}from"./src/util/animation/AnimationRegistry.min.mjs";import{Observable as l}from"./src/Observable.min.mjs";import{Point as u}from"./src/Point.min.mjs";import{createCollectionMixin as d}from"./src/Collection.min.mjs";import{StaticCanvasDOMManager as f}from"./src/canvas/DOMManagers/StaticCanvasDOMManager.min.mjs";import{StaticCanvas as p}from"./src/canvas/StaticCanvas.min.mjs";import{Color as m}from"./src/color/Color.min.mjs";import{Shadow as h}from"./src/Shadow.min.mjs";import{Intersection as g}from"./src/Intersection.min.mjs";import{FabricObject as _}from"./src/shapes/Object/Object.min.mjs";import{Control as v}from"./src/controls/Control.min.mjs";import{InteractiveFabricObject as y}from"./src/shapes/Object/InteractiveObject.min.mjs";import{FabricObject as b}from"./src/shapes/Object/FabricObject.min.mjs";import{Rect as x}from"./src/shapes/Rect.min.mjs";import{LayoutStrategy as S}from"./src/LayoutManager/LayoutStrategies/LayoutStrategy.min.mjs";import{FitContentLayout as C}from"./src/LayoutManager/LayoutStrategies/FitContentLayout.min.mjs";import{LayoutManager as w}from"./src/LayoutManager/LayoutManager.min.mjs";import{Group as T}from"./src/shapes/Group.min.mjs";import{util_exports as E}from"./src/util/index.min.mjs";import{CanvasDOMManager as D}from"./src/canvas/DOMManagers/CanvasDOMManager.min.mjs";import{controls_exports as O}from"./src/controls/index.min.mjs";import{Canvas as k}from"./src/canvas/Canvas.min.mjs";import{Gradient as A}from"./src/gradient/Gradient.min.mjs";import{Pattern as te}from"./src/Pattern/Pattern.min.mjs";import{BaseBrush as j}from"./src/brushes/BaseBrush.min.mjs";import{Path as M}from"./src/shapes/Path.min.mjs";import{PencilBrush as N}from"./src/brushes/PencilBrush.min.mjs";import{Circle as P}from"./src/shapes/Circle.min.mjs";import{CircleBrush as F}from"./src/brushes/CircleBrush.min.mjs";import{SprayBrush as I}from"./src/brushes/SprayBrush.min.mjs";import{PatternBrush as L}from"./src/brushes/PatternBrush.min.mjs";import{Line as R}from"./src/shapes/Line.min.mjs";import{Triangle as z}from"./src/shapes/Triangle.min.mjs";import{Ellipse as B}from"./src/shapes/Ellipse.min.mjs";import{Polyline as V}from"./src/shapes/Polyline.min.mjs";import{Polygon as H}from"./src/shapes/Polygon.min.mjs";import{FabricText as U}from"./src/shapes/Text/Text.min.mjs";import{IText as W}from"./src/shapes/IText/IText.min.mjs";import{Textbox as G}from"./src/shapes/Textbox.min.mjs";import{ClipPathLayout as K}from"./src/LayoutManager/LayoutStrategies/ClipPathLayout.min.mjs";import{FixedLayout as q}from"./src/LayoutManager/LayoutStrategies/FixedLayout.min.mjs";import{ActiveSelection as J}from"./src/shapes/ActiveSelection.min.mjs";import{Canvas2dFilterBackend as Y}from"./src/filters/Canvas2dFilterBackend.min.mjs";import{WebGLFilterBackend as X}from"./src/filters/WebGLFilterBackend.min.mjs";import{getFilterBackend as Z,initFilterBackend as Q,setFilterBackend as ne}from"./src/filters/FilterBackend.min.mjs";import{FabricImage as $}from"./src/shapes/Image.min.mjs";import{parseSVGDocument as re}from"./src/parser/parseSVGDocument.min.mjs";import{loadSVGFromString as ie}from"./src/parser/loadSVGFromString.min.mjs";import{loadSVGFromURL as ae}from"./src/parser/loadSVGFromURL.min.mjs";import{isPutImageFaster as oe,isWebGLPipelineState as se}from"./src/filters/utils.min.mjs";import{filters_exports as ce}from"./src/filters/filters.min.mjs";export{J as ActiveSelection,j as BaseBrush,_ as BaseFabricObject,k as Canvas,Y as Canvas2dFilterBackend,D as CanvasDOMManager,P as Circle,F as CircleBrush,K as ClipPathLayout,m as Color,v as Control,B as Ellipse,$ as FabricImage,b as FabricObject,U as FabricText,C as FitContentLayout,q as FixedLayout,A as Gradient,T as Group,W as IText,$ as Image,y as InteractiveFabricObject,g as Intersection,w as LayoutManager,S as LayoutStrategy,R as Line,b as Object,l as Observable,M as Path,te as Pattern,L as PatternBrush,N as PencilBrush,u as Point,H as Polygon,V as Polyline,x as Rect,h as Shadow,I as SprayBrush,p as StaticCanvas,f as StaticCanvasDOMManager,U as Text,G as Textbox,z as Triangle,X as WebGLFilterBackend,i as cache,s as classRegistry,e as config,O as controlsUtils,d as createCollectionMixin,ce as filters,t as getEnv,n as getFabricDocument,r as getFabricWindow,Z as getFilterBackend,o as iMatrix,Q as initFilterBackend,oe as isPutImageFaster,se as isWebGLPipelineState,ie as loadSVGFromString,ae as loadSVGFromURL,re as parseSVGDocument,c as runningAnimations,ee as setEnv,ne as setFilterBackend,E as util,a as version};
+export*from"@fabricjs/browser";

package/dist/fabric.mjs

@@ -1,57 +1 @@
-import { config } from "./src/config.mjs";
-import { getEnv, getFabricDocument, getFabricWindow, setEnv } from "./src/env/index.mjs";
-import { cache } from "./src/cache.mjs";
-import { VERSION, iMatrix } from "./src/constants.mjs";
-import { classRegistry } from "./src/ClassRegistry.mjs";
-import { runningAnimations } from "./src/util/animation/AnimationRegistry.mjs";
-import { Observable } from "./src/Observable.mjs";
-import { Point } from "./src/Point.mjs";
-import { createCollectionMixin } from "./src/Collection.mjs";
-import { StaticCanvasDOMManager } from "./src/canvas/DOMManagers/StaticCanvasDOMManager.mjs";
-import { StaticCanvas } from "./src/canvas/StaticCanvas.mjs";
-import { Color } from "./src/color/Color.mjs";
-import { Shadow } from "./src/Shadow.mjs";
-import { Intersection } from "./src/Intersection.mjs";
-import { FabricObject } from "./src/shapes/Object/Object.mjs";
-import { Control } from "./src/controls/Control.mjs";
-import { InteractiveFabricObject } from "./src/shapes/Object/InteractiveObject.mjs";
-import { FabricObject as FabricObject$1 } from "./src/shapes/Object/FabricObject.mjs";
-import { Rect } from "./src/shapes/Rect.mjs";
-import { LayoutStrategy } from "./src/LayoutManager/LayoutStrategies/LayoutStrategy.mjs";
-import { FitContentLayout } from "./src/LayoutManager/LayoutStrategies/FitContentLayout.mjs";
-import { LayoutManager } from "./src/LayoutManager/LayoutManager.mjs";
-import { Group } from "./src/shapes/Group.mjs";
-import { util_exports } from "./src/util/index.mjs";
-import { CanvasDOMManager } from "./src/canvas/DOMManagers/CanvasDOMManager.mjs";
-import { controls_exports } from "./src/controls/index.mjs";
-import { Canvas } from "./src/canvas/Canvas.mjs";
-import { Gradient } from "./src/gradient/Gradient.mjs";
-import { Pattern } from "./src/Pattern/Pattern.mjs";
-import { BaseBrush } from "./src/brushes/BaseBrush.mjs";
-import { Path } from "./src/shapes/Path.mjs";
-import { PencilBrush } from "./src/brushes/PencilBrush.mjs";
-import { Circle } from "./src/shapes/Circle.mjs";
-import { CircleBrush } from "./src/brushes/CircleBrush.mjs";
-import { SprayBrush } from "./src/brushes/SprayBrush.mjs";
-import { PatternBrush } from "./src/brushes/PatternBrush.mjs";
-import { Line } from "./src/shapes/Line.mjs";
-import { Triangle } from "./src/shapes/Triangle.mjs";
-import { Ellipse } from "./src/shapes/Ellipse.mjs";
-import { Polyline } from "./src/shapes/Polyline.mjs";
-import { Polygon } from "./src/shapes/Polygon.mjs";
-import { FabricText } from "./src/shapes/Text/Text.mjs";
-import { IText } from "./src/shapes/IText/IText.mjs";
-import { Textbox } from "./src/shapes/Textbox.mjs";
-import { ClipPathLayout } from "./src/LayoutManager/LayoutStrategies/ClipPathLayout.mjs";
-import { FixedLayout } from "./src/LayoutManager/LayoutStrategies/FixedLayout.mjs";
-import { ActiveSelection } from "./src/shapes/ActiveSelection.mjs";
-import { Canvas2dFilterBackend } from "./src/filters/Canvas2dFilterBackend.mjs";
-import { WebGLFilterBackend } from "./src/filters/WebGLFilterBackend.mjs";
-import { getFilterBackend, initFilterBackend, setFilterBackend } from "./src/filters/FilterBackend.mjs";
-import { FabricImage } from "./src/shapes/Image.mjs";
-import { parseSVGDocument } from "./src/parser/parseSVGDocument.mjs";
-import { loadSVGFromString } from "./src/parser/loadSVGFromString.mjs";
-import { loadSVGFromURL } from "./src/parser/loadSVGFromURL.mjs";
-import { isPutImageFaster, isWebGLPipelineState } from "./src/filters/utils.mjs";
-import { filters_exports } from "./src/filters/filters.mjs";
-export { ActiveSelection, BaseBrush, FabricObject as BaseFabricObject, Canvas, Canvas2dFilterBackend, CanvasDOMManager, Circle, CircleBrush, ClipPathLayout, Color, Control, Ellipse, FabricImage, FabricObject$1 as FabricObject, FabricText, FitContentLayout, FixedLayout, Gradient, Group, IText, FabricImage as Image, InteractiveFabricObject, Intersection, LayoutManager, LayoutStrategy, Line, FabricObject$1 as Object, Observable, Path, Pattern, PatternBrush, PencilBrush, Point, Polygon, Polyline, Rect, Shadow, SprayBrush, StaticCanvas, StaticCanvasDOMManager, FabricText as Text, Textbox, Triangle, WebGLFilterBackend, cache, classRegistry, config, controls_exports as controlsUtils, createCollectionMixin, filters_exports as filters, getEnv, getFabricDocument, getFabricWindow, getFilterBackend, iMatrix, initFilterBackend, isPutImageFaster, isWebGLPipelineState, loadSVGFromString, loadSVGFromURL, parseSVGDocument, runningAnimations, setEnv, setFilterBackend, util_exports as util, VERSION as version };
+export * from "@fabricjs/browser";

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export * from './fabric';
+export * from '@fabricjs/browser';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}