@lightningjs/renderer 3.0.0-beta9 → 3.0.0

package/README.md

@@ -1,147 +1,230 @@
-# Lightning 3 Renderer
-
-A powerful 2D scene renderer designed for rendering highly performant user
-interfaces on web browsers running on embedded devices using WebGL.
-
-The Renderer is part of the [LightningJS](https://lightningjs.io) project. While it is possible to use the renderer directly, it is not recommended. Instead, Lightning 3 works best when combined with [Blits](https://lightningjs.io/v3-docs/blits/getting_started/intro.html).
-
-## Setup & Commands
-
-```
-# Install renderer + example dependencies
-pnpm install
-
-# Build Renderer
-pnpm build
-
-# Build Renderer (watch mode)
-pnpm watch
-
-# Run unit tests
-pnpm test
-
-# Run Visual Regression Tests
-pnpm test:visual
-
-# Build API Documentation (builds into ./typedocs folder)
-pnpm typedoc
-
-# Launch Example Tests in dev mode (includes Build Renderer (watch mode))
-pnpm start
-
-# Launch Example Tests in production mode
-# IMPORTANT: To run test examples on embedded devices that use older browser versions
-# you MUST run the examples in this mode.
-pnpm start:prod
-```
-
-## Browser Targets
-
-The Lightning 3 Renderer's goal is to work with the following browser versions and above:
-
-- Chrome v38 (Released October 7, 2014)
-
-Any JavaScript language features or browser APIs that cannot be automatically transpiled or polyfilled by industry standard transpilers (such as Babel) to target these versions must be carefully considered before use.
-
-For a more detailed and comprehensive list of browsers and their features please see [browsers](./BROWSERS.md).
-
-## Example Tests
-
-The Example Tests sub-project define a set of tests for various Renderer
-features. This is NOT an automated test. The command below will launch a
-web server which can be accessed by a web browser for manual testing. However,
-many of the Example Tests define Snapshots for the Visual Regression Test Runner
-(see below).
-
-The Example Tests can be launched with:
-
-```
-pnpm start
-```
-
-A hosted version can be found [here](https://lightning-js.github.io/renderer/).
-
-This supports modern browsers as well as Chrome 38 and above through a legacy build.
-
-See [examples/README.md](./examples/README.md) for more info.
-
-## Visual Regression Tests
-
-In order to prevent bugs on existing Renderer features when new features or bug
-fixes are added, the Renderer includes a Visual Regression Test Runner along
-with a set of certified snapshot files that are checked into the repository.
-
-These tests can be launched with:
-
-```
-pnpm test:visual
-```
-
-The captured Snapshots of these tests are optionally defined in the individual
-Example Tests.
-
-See [visual-regression/README.md](./visual-regression/README.md) for more info.
-
-## Manual Regression Tests
-
-See [docs/ManualRegressionTests.md].
-
-## Release Procedure
-
-See [RELEASE.md](./RELEASE.md)
-
-## Installing Fonts
-
-Fonts can be installed into the Font Manager exposed by the Renderer's Stage.
-There are two types of fonts that you can install, Web/Canvas2D fonts (WebTrFontFace)
-and SDF fonts (SdfTrFontFace). Install that fonts that your applications needs
-at start up so they are ready when your application is rendered.
-
-```ts
-import {
-  RendererMain,
-  WebTrFontFace,
-  SdfTrFontFace,
-} from '@lightningjs/renderer';
-
-import {
-  WebGlCoreRenderer,
-  SdfTextRenderer,
-} from '@lightningjs/renderer/webgl';
-import { CanvasTextRenderer } from '@lightningjs/renderer/canvas';
-
-const renderer = new RendererMain(
-  {
-    appWidth: 1920,
-    appHeight: 1080,
-    renderEngine: WebGlCoreRenderer,
-    fontEngines: [SdfTextRenderer, CanvasTextRenderer],
-    // ...Other Renderer Config
-  },
-  'app', // id of div to insert Canvas.
-);
-
-// Load fonts into renderer
-renderer.stage.fontManager.addFontFace(
-  new WebTrFontFace('Ubuntu', {}, '/fonts/Ubuntu-Regular.ttf'),
-);
-
-renderer.stage.fontManager.addFontFace(
-  new SdfTrFontFace(
-    'Ubuntu',
-    {},
-    'msdf',
-    stage,
-    '/fonts/Ubuntu-Regular.msdf.png',
-    '/fonts/Ubuntu-Regular.msdf.json',
-  ),
-);
-```
-
-Please note that the WebGL renderer supports both SDF Fonts and Web Fonts, however the
-Canvas renderer only supports Web Fonts:
-
-| Font Type Renderer | SDF Font | Web Font |
-| ------------------ | -------- | -------- |
-| WebGL              | Y        | Y        |
-| Canvas             | N        | Y        |
+# Lightning 3 Renderer
+
+A powerful 2D scene renderer designed for rendering highly performant user
+interfaces on web browsers running on embedded devices using WebGL.
+
+The Renderer is part of the [LightningJS](https://lightningjs.io) project. While it is possible to use the renderer directly, it is not recommended. Instead, Lightning 3 works best when combined with [Blits](https://lightningjs.io/v3-docs/blits/getting_started/intro.html).
+
+## Setup & Commands
+
+```
+# Install renderer + example dependencies
+pnpm install
+
+# Build Renderer
+pnpm build
+
+# Build Renderer (watch mode)
+pnpm watch
+
+# Run unit tests
+pnpm test
+
+# Run Visual Regression Tests
+pnpm test:visual
+
+# Build API Documentation (builds into ./typedocs folder)
+pnpm typedoc
+
+# Launch Example Tests in dev mode (includes Build Renderer (watch mode))
+pnpm start
+
+# Launch Example Tests in production mode
+# IMPORTANT: To run test examples on embedded devices that use older browser versions
+# you MUST run the examples in this mode.
+pnpm start:prod
+```
+
+## Browser Targets
+
+The Lightning 3 Renderer's goal is to work with the following browser versions and above:
+
+- Chrome v38 (Released October 7, 2014)
+
+Any JavaScript language features or browser APIs that cannot be automatically transpiled or polyfilled by industry standard transpilers (such as Babel) to target these versions must be carefully considered before use.
+
+For a more detailed and comprehensive list of browsers and their features please see [browsers](./BROWSERS.md).
+
+## Platform Architecture
+
+The Lightning 3 Renderer uses a modular platform architecture that allows it to adapt to different browser capabilities and environments. This enables optimal performance across a wide range of devices, from modern browsers to legacy embedded systems.
+
+### Available Platforms
+
+The Renderer includes several platform implementations, each tailored for specific browser capabilities:
+
+#### WebPlatform (Default)
+
+The standard platform for modern browsers with full WebGL and createImageBitmap support.
+
+- Uses XMLHttpRequest for loading resources
+- Full createImageBitmap API with options (premultiplyAlpha, colorSpaceConversion, imageOrientation)
+- Supports image cropping
+- Multi-threaded image processing via Web Workers
+- **Use case:** Modern browsers, default choice for most applications
+
+#### WebPlatformNext
+
+Platform using the modern Fetch API instead of XMLHttpRequest.
+
+- Uses Fetch API for loading resources (promise-based, Service Worker compatible)
+- Full createImageBitmap API with options
+- Supports image cropping
+- Multi-threaded image processing via Web Workers
+- **Use case:** Modern browsers where Fetch API is preferred, progressive web apps
+
+#### WebPlatformChrome50
+
+Compatibility platform for browsers with limited createImageBitmap support (Chrome 50-51).
+
+- Uses XMLHttpRequest for loading resources
+- Limited createImageBitmap API (no options or cropping parameters)
+- Multi-threaded image processing via Web Workers (if enabled)
+- **Use case:** Chrome 50-51, browsers with basic createImageBitmap support
+
+#### WebPlatformLegacy
+
+Legacy platform for older browsers without createImageBitmap support.
+
+- Uses direct Image element loading (no blob conversion for URLs)
+- HTMLImageElement instead of createImageBitmap
+- Single-threaded image processing (no Web Workers)
+- No image cropping support
+- No compressed texture support
+- **Use case:** Chrome 38-49, older embedded device browsers
+
+### Using a Platform
+
+Platforms can be specified when initializing the Renderer:
+
+```ts
+import { RendererMain } from '@lightningjs/renderer';
+import { WebGlRenderer } from '@lightningjs/renderer/webgl';
+import {
+  WebPlatform,
+  WebPlatformNext,
+  WebPlatformChrome50,
+  WebPlatformLegacy,
+} from '@lightningjs/renderer/platforms';
+
+const renderer = new RendererMain(
+  {
+    appWidth: 1920,
+    appHeight: 1080,
+    renderEngine: WebGlRenderer,
+    platform: WebPlatformLegacy, // Use legacy platform for older browsers
+    // ...Other Renderer Config
+  },
+  'app',
+);
+```
+
+**Note:** `WebPlatformLegacy` automatically sets `numImageWorkers` to 0 since it doesn't support Web Workers.
+
+### Creating Custom Platforms
+
+You can create your own custom platform tailored to your specific device or environment by extending the `Platform` base class or one of the existing platform implementations.
+
+**Key methods you can override:**
+
+- `fetch(url: string): Promise<Blob>` - Resource loading
+- `createImage(...)` - Image bitmap creation
+- `loadImage(...)` - Complete image loading pipeline
+- `loadSvg(...)` - SVG loading
+- `loadCompressedTexture(...)` - Compressed texture loading
+- `createCanvas()` - Canvas element creation
+- `createContext()` - WebGL context creation
+- `startLoop(stage)` - Animation loop implementation
+
+This allows you to optimize the Renderer for proprietary platforms, embedded systems, or environments with unique capabilities and constraints.
+
+## Example Tests
+
+The Example Tests sub-project define a set of tests for various Renderer
+features. This is NOT an automated test. The command below will launch a
+web server which can be accessed by a web browser for manual testing. However,
+many of the Example Tests define Snapshots for the Visual Regression Test Runner
+(see below).
+
+The Example Tests can be launched with:
+
+```
+pnpm start
+```
+
+A hosted version can be found [here](https://lightning-js.github.io/renderer/).
+
+This supports modern browsers as well as Chrome 38 and above through a legacy build.
+
+See [examples/README.md](./examples/README.md) for more info.
+
+## Visual Regression Tests
+
+In order to prevent bugs on existing Renderer features when new features or bug
+fixes are added, the Renderer includes a Visual Regression Test Runner along
+with a set of certified snapshot files that are checked into the repository.
+
+These tests can be launched with:
+
+```
+pnpm test:visual
+```
+
+The captured Snapshots of these tests are optionally defined in the individual
+Example Tests.
+
+See [visual-regression/README.md](./visual-regression/README.md) for more info.
+
+## Manual Regression Tests
+
+See [docs/ManualRegressionTests.md].
+
+## Release Procedure
+
+See [RELEASE.md](./RELEASE.md)
+
+## Installing Fonts
+
+Fonts can be installed into the Font Manager exposed by the Renderer's Stage.
+There are two types of fonts that you can install, Web/Canvas2D fonts (WebTrFontFace)
+and SDF fonts (SdfTrFontFace). Install that fonts that your applications needs
+at start up so they are ready when your application is rendered.
+
+```ts
+import { RendererMain } from '@lightningjs/renderer';
+
+import {
+  WebGlCoreRenderer,
+  SdfTextRenderer,
+} from '@lightningjs/renderer/webgl';
+import { CanvasTextRenderer } from '@lightningjs/renderer/canvas';
+
+const renderer = new RendererMain(
+  {
+    appWidth: 1920,
+    appHeight: 1080,
+    renderEngine: WebGlCoreRenderer,
+    fontEngines: [SdfTextRenderer, CanvasTextRenderer],
+    // ...Other Renderer Config
+  },
+  'app', // id of div to insert Canvas.
+);
+
+// Load fonts by explicitly specifying the renderer type
+await stage.loadFont('canvas', {
+  fontFamily: 'myWebFont',
+  fontUrl: '/fonts/my-font.ttf',
+});
+
+await stage.loadFont('sdf', {
+  fontFamily: 'mySdfFont',
+  atlasUrl: '/fonts/my-font-atlas.png',
+  atlasDataUrl: '/fonts/my-font-data.json',
+});
+```
+
+For more information see [Font Loading](./docs/fontLoading.md)
+
+## Migration Guide
+
+Upgrading from Lightning 3 v2.x? See the [Migration Guide](./docs/migration-2x-to-3.0.md) for detailed information about breaking changes and how to update your code.

package/dist/exports/canvas.d.ts

@@ -16,7 +16,7 @@
  *
  * @packageDocumentation
  */
-export { CanvasTextRenderer } from '../src/core/text-rendering/renderers/CanvasTextRenderer.js';
+export { default as CanvasTextRenderer } from '../src/core/text-rendering/CanvasTextRenderer.js';
 export { CanvasRenderer } from '../src/core/renderers/canvas/CanvasRenderer.js';
 export { CanvasTexture } from '../src/core/renderers/canvas/CanvasTexture.js';
 export * from '../src/core/renderers/canvas/CanvasShaderNode.js';

package/dist/exports/canvas.js

@@ -34,7 +34,7 @@
  *
  * @packageDocumentation
  */
-export { CanvasTextRenderer } from '../src/core/text-rendering/renderers/CanvasTextRenderer.js';
+export { default as CanvasTextRenderer } from '../src/core/text-rendering/CanvasTextRenderer.js';
 export { CanvasRenderer } from '../src/core/renderers/canvas/CanvasRenderer.js';
 export { CanvasTexture } from '../src/core/renderers/canvas/CanvasTexture.js';
 export * from '../src/core/renderers/canvas/CanvasShaderNode.js';

package/dist/exports/canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../exports/canvas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,cAAc,kDAAkD,CAAC;AACjE;;GAEG;AACH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC"}
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../exports/canvas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,cAAc,kDAAkD,CAAC;AACjE;;GAEG;AACH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/exports/index.d.ts

@@ -22,12 +22,14 @@ export * from '../src/main-api/Renderer.js';
 export * from '../src/common/IAnimationController.js';
 export * from '../src/common/CommonTypes.js';
 export { CoreTextureManager, type TextureMap, } from '../src/core/CoreTextureManager.js';
+export { TextureError, TextureErrorCode, isTextureError, } from '../src/core/TextureError.js';
+export type { TextRenderer } from '../src/core/text-rendering/TextRenderer.js';
 export type { MemoryInfo } from '../src/core/TextureMemoryManager.js';
-export type { TextRendererMap } from '../src/core/text-rendering/renderers/TextRenderer.js';
-export type { TrFontFaceMap } from '../src/core/text-rendering/font-face-types/TrFontFace.js';
 export type { AnimationSettings } from '../src/core/animations/CoreAnimation.js';
+export type { TimingFunction } from '../src/core/utils.js';
 export type { Inspector } from '../src/main-api/Inspector.js';
-export type { CoreNodeRenderState } from '../src/core/CoreNode.js';
+export { CoreNode, type CoreNodeProps, type CoreNodeRenderState } from '../src/core/CoreNode.js';
+export { CoreTextNode, type CoreTextNodeProps } from '../src/core/CoreTextNode.js';
 export * from '../src/core/renderers/CoreShaderNode.js';
 export * from '../src/core/shaders/templates/BorderTemplate.js';
 export * from '../src/core/shaders/templates/HolePunchTemplate.js';
@@ -39,9 +41,6 @@ export * from '../src/core/renderers/webgl/WebGlShaderProgram.js';
 export type { ShaderProgramSources } from '../src/core/renderers/webgl/internal/ShaderUtils.js';
 export * from '../src/core/textures/Texture.js';
 export { ImageTexture } from '../src/core/textures/ImageTexture.js';
-export * from '../src/core/text-rendering/font-face-types/TrFontFace.js';
-export * from '../src/core/text-rendering/font-face-types/WebTrFontFace.js';
-export * from '../src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js';
 export type * from '../src/core/Stage.js';
 /**
  * @deprecated Use `import { WebGlRenderer } @lightningjs/renderer/webgl` instead

package/dist/exports/index.js

@@ -42,6 +42,9 @@ export * from '../src/common/CommonTypes.js';
 // Selected types exported from the Core Renderer that can be used in the
 // context of the main API.
 export { CoreTextureManager, } from '../src/core/CoreTextureManager.js';
+export { TextureError, TextureErrorCode, isTextureError, } from '../src/core/TextureError.js';
+export { CoreNode } from '../src/core/CoreNode.js';
+export { CoreTextNode } from '../src/core/CoreTextNode.js';
 export * from '../src/core/renderers/CoreShaderNode.js';
 export * from '../src/core/shaders/templates/BorderTemplate.js';
 export * from '../src/core/shaders/templates/HolePunchTemplate.js';
@@ -54,9 +57,4 @@ export * from '../src/core/renderers/webgl/WebGlShaderProgram.js';
 // Textures
 export * from '../src/core/textures/Texture.js';
 export { ImageTexture } from '../src/core/textures/ImageTexture.js';
-// Text Rendering & Fonts
-// export * from '../src/core/text-rendering/renderers/TextRenderer.js';
-export * from '../src/core/text-rendering/font-face-types/TrFontFace.js';
-export * from '../src/core/text-rendering/font-face-types/WebTrFontFace.js';
-export * from '../src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js';
 //# sourceMappingURL=index.js.map

package/dist/exports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../exports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAE7C,yEAAyE;AACzE,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,GAEnB,MAAM,mCAAmC,CAAC;AAQ3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,iDAAiD,CAAC;AAChE,cAAc,oDAAoD,CAAC;AACnE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,yDAAyD,CAAC;AACxE,cAAc,yDAAyD,CAAC;AAExE,UAAU;AACV,cAAc,mDAAmD,CAAC;AAGlE,WAAW;AACX,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpE,yBAAyB;AACzB,wEAAwE;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,2EAA2E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../exports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAE7C,yEAAyE;AACzE,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,GAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,QAAQ,EAAgD,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,YAAY,EAA0B,MAAM,6BAA6B,CAAC;AAEnF,cAAc,yCAAyC,CAAC;AACxD,cAAc,iDAAiD,CAAC;AAChE,cAAc,oDAAoD,CAAC;AACnE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,yDAAyD,CAAC;AACxE,cAAc,yDAAyD,CAAC;AAExE,UAAU;AACV,cAAc,mDAAmD,CAAC;AAGlE,WAAW;AACX,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/exports/platform.d.ts

@@ -0,0 +1,7 @@
+export { Platform, type PlatformSettings, } from '../src/core/platforms/Platform.js';
+export { WebPlatform } from '../src/core/platforms/web/WebPlatform.js';
+export { WebPlatformNext } from '../src/core/platforms/web/WebPlatformNext.js';
+export { WebPlatformChrome50 } from '../src/core/platforms/web/WebPlatformChrome50.js';
+export { WebPlatformLegacy } from '../src/core/platforms/web/WebPlatformLegacy.js';
+export { GlContextWrapper } from '../src/core/platforms/GlContextWrapper.js';
+export { WebGlContextWrapper } from '../src/core/platforms/web/WebGlContextWrapper.js';

package/dist/exports/platform.js

@@ -0,0 +1,27 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2026 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { Platform, } from '../src/core/platforms/Platform.js';
+export { WebPlatform } from '../src/core/platforms/web/WebPlatform.js';
+export { WebPlatformNext } from '../src/core/platforms/web/WebPlatformNext.js';
+export { WebPlatformChrome50 } from '../src/core/platforms/web/WebPlatformChrome50.js';
+export { WebPlatformLegacy } from '../src/core/platforms/web/WebPlatformLegacy.js';
+// GL Context Wrappers
+export { GlContextWrapper } from '../src/core/platforms/GlContextWrapper.js';
+export { WebGlContextWrapper } from '../src/core/platforms/web/WebGlContextWrapper.js';
+//# sourceMappingURL=platform.js.map

package/dist/exports/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../exports/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,QAAQ,GAET,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAEnF,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC"}

package/dist/exports/webgl.d.ts

@@ -15,7 +15,7 @@
  *
  * @packageDocumentation
  */
-export { SdfTextRenderer } from '../src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js';
+export * from '../src/core/text-rendering/SdfTextRenderer.js';
 export { WebGlRenderer } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export { WebGlCtxTexture } from '../src/core/renderers/webgl/WebGlCtxTexture.js';
 export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
@@ -25,3 +25,4 @@ export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
 export { WebGlRenderer as WebGlCoreRenderer } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export { WebGlRenderer as WebGlCoreCtxTexture } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export * as shaders from './webgl-shaders.js';
+export { default as SdfTextRenderer } from '../src/core/text-rendering/SdfTextRenderer.js';

package/dist/exports/webgl.js

@@ -33,7 +33,7 @@
  *
  * @packageDocumentation
  */
-export { SdfTextRenderer } from '../src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js';
+export * from '../src/core/text-rendering/SdfTextRenderer.js';
 export { WebGlRenderer } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export { WebGlCtxTexture } from '../src/core/renderers/webgl/WebGlCtxTexture.js';
 export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
@@ -43,4 +43,5 @@ export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
 export { WebGlRenderer as WebGlCoreRenderer } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export { WebGlRenderer as WebGlCoreCtxTexture } from '../src/core/renderers/webgl/WebGlRenderer.js';
 export * as shaders from './webgl-shaders.js';
+export { default as SdfTextRenderer } from '../src/core/text-rendering/SdfTextRenderer.js';
 //# sourceMappingURL=webgl.js.map

package/dist/exports/webgl.js.map

@@ -1 +1 @@
-{"version":3,"file":"webgl.js","sourceRoot":"","sources":["../../exports/webgl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yEAAyE,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEjF,cAAc,gDAAgD,CAAC;AAE/D;;GAEG;AACH,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAEpG,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"webgl.js","sourceRoot":"","sources":["../../exports/webgl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEjF,cAAc,gDAAgD,CAAC;AAE/D;;GAEG;AACH,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAEpG,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/src/common/CommonTypes.d.ts

@@ -1,4 +1,5 @@
 import type { CoreNodeRenderState } from '../core/CoreNode.js';
+import type { TextureError } from '../core/TextureError.js';
 /**
  * Types shared between Main Space and Core Space
  *
@@ -10,8 +11,8 @@ import type { CoreNodeRenderState } from '../core/CoreNode.js';
  * Represents a width and height.
  */
 export interface Dimensions {
-    width: number;
-    height: number;
+    w: number;
+    h: number;
 }
 /**
  * Payload for when text is loaded
@@ -43,7 +44,7 @@ export type NodeTextFailedPayload = {
  */
 export type NodeTextureFailedPayload = {
     type: 'texture';
-    error: Error;
+    error: TextureError;
 };
 /**
  * Payload for when texture failed to load
@@ -51,6 +52,13 @@ export type NodeTextureFailedPayload = {
 export type NodeTextureFreedPayload = {
     type: 'texture';
 };
+/**
+ * Payload for when node renderable status changes
+ */
+export type NodeRenderablePayload = {
+    type: 'renderable';
+    isRenderable: boolean;
+};
 /**
  * Combined type for all failed payloads
  */
@@ -63,6 +71,10 @@ export type NodeLoadedEventHandler = (target: any, payload: NodeLoadedPayload) =
  * Event handler for when the texture/text of a node has failed to load
  */
 export type NodeFailedEventHandler = (target: any, payload: NodeFailedPayload) => void;
+/**
+ * Event handler for when the renderable status of a node changes
+ */
+export type NodeRenderableEventHandler = (target: any, payload: NodeRenderablePayload) => void;
 export type NodeRenderStatePayload = {
     type: 'renderState';
     payload: CoreNodeRenderState;

package/dist/src/core/AutosizeManager.d.ts

@@ -0,0 +1,29 @@
+import type { CoreNode } from './CoreNode.js';
+/**
+ * Result of autosize calculation containing the new dimensions
+ */
+interface AutosizeResult {
+    width: number;
+    height: number;
+    hasChanged: boolean;
+}
+/**
+ * Creates an autosize manager for efficient child bounds calculation
+ *
+ * @remarks
+ * This function creates a closure-based manager that tracks child transform
+ * changes and calculates parent dimensions based on children's bounding boxes.
+ * It's optimized for performance with minimal allocations and fast lookups.
+ *
+ * @param parentNode - The autosize parent node
+ * @returns Object with autosize management methods
+ */
+export declare function createAutosizeManager(parentNode: CoreNode): {
+    addOrUpdateChild: (child: CoreNode) => void;
+    removeChild: (child: CoreNode) => void;
+    calculateAutosize: () => AutosizeResult;
+    deactivate: () => void;
+    readonly active: boolean;
+    readonly childCount: number;
+};
+export {};