@tresjs/core 5.2.1 → 5.3.1

package/dist/template-compiler-options.d.mts

@@ -1,7 +1,7 @@
 /**
   * name: @tresjs/core
-  * version: v5.2.1
-  * (c) 2025
+  * version: v5.3.1
+  * (c) 2026
   * description: Declarative ThreeJS using Vue Components
   * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
   */

package/dist/template-compiler-options.mjs

@@ -1,7 +1,7 @@
 /**
   * name: @tresjs/core
-  * version: v5.2.1
-  * (c) 2025
+  * version: v5.3.1
+  * (c) 2026
   * description: Declarative ThreeJS using Vue Components
   * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
   */

package/dist/tres.d.ts

@@ -1,11 +1,11 @@
 /**
   * name: @tresjs/core
-  * version: v5.2.1
-  * (c) 2025
+  * version: v5.3.1
+  * (c) 2026
   * description: Declarative ThreeJS using Vue Components
   * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
   */
-import * as vue0 from "vue";
+import * as vue9 from "vue";
 import { App, ComputedRef, DefineComponent, MaybeRef, MaybeRefOrGetter, Reactive, Ref, ShallowRef, VNode, VNodeRef } from "vue";
 import * as THREE from "three";
 import { BufferGeometry, Camera, Color, ColorRepresentation, ColorSpace, Event, Fog, Group, Layers, Light, Loader, LoadingManager, Material, Mesh, Object3D, Object3DEventMap, OrthographicCamera, PerspectiveCamera, Scene, ShadowMapType, ToneMapping, Vector3, WebGLRenderer } from "three";
@@ -312,7 +312,7 @@ declare function useRendererManager({
   onReady: _vueuse_core0.EventHookOn<TresRenderer>;
   onRender: _vueuse_core0.EventHookOn<TresRenderer>;
   invalidate: (amountOfFramesToInvalidate?: number) => void;
-  canBeInvalidated: vue0.ComputedRef<boolean>;
+  canBeInvalidated: vue9.ComputedRef<boolean>;
   mode: "always" | "on-demand" | "manual" | undefined;
   replaceRenderFunction: (fn: RenderFunction) => void;
 };
@@ -363,10 +363,10 @@ type AttachFnType = (parent: any, self: TresInstance) => () => void;
 type AttachType = string | AttachFnType;
 type DisposeType = ((self: TresInstance) => void) | boolean | 'default';
 type ConstructorRepresentation = new (...args: any[]) => any;
-type NonFunctionKeys<P$1> = { [K in keyof P$1]-?: P$1[K] extends ((...args: any[]) => any) ? never : K }[keyof P$1];
-type Overwrite<P$1, O> = Omit<P$1, NonFunctionKeys<O>> & O;
+type NonFunctionKeys<P> = { [K in keyof P]-?: P[K] extends ((...args: any[]) => any) ? never : K }[keyof P];
+type Overwrite<P, O> = Omit<P, NonFunctionKeys<O>> & O;
 type Properties<T> = Pick<T, NonFunctionKeys<T>>;
-type Mutable<P$1> = { [K in keyof P$1]: P$1[K] | Readonly<P$1[K]> };
+type Mutable<P> = { [K in keyof P]: P[K] | Readonly<P[K]> };
 type Args<T> = T extends ConstructorRepresentation ? ConstructorParameters<T> : any[];
 interface TresCatalogue {
   [name: string]: ConstructorRepresentation;
@@ -378,8 +378,8 @@ type TresCamera = THREE.OrthographicCamera | THREE.PerspectiveCamera;
  * @template T - The type of the object.
  * @template P - The type of the arguments.
  */
-interface InstanceProps<T = any, P$1 = any> {
-  args?: Args<P$1>;
+interface InstanceProps<T = any, P = any> {
+  args?: Args<P>;
   object?: T;
   visible?: boolean;
   dispose?: null;
@@ -456,17 +456,17 @@ type TresContextWithClock = TresContext & {
   delta: number;
   elapsed: number;
 };
-type WithMathProps<P$1> = { [K in keyof P$1]: P$1[K] extends MathRepresentation | THREE.Euler ? MathType<P$1[K]> : P$1[K] };
+type WithMathProps<P> = { [K in keyof P]: P[K] extends MathRepresentation | THREE.Euler ? MathType<P[K]> : P[K] };
 interface RaycastableRepresentation {
   raycast: (raycaster: THREE.Raycaster, intersects: THREE.Intersection[]) => void;
 }
-type EventProps<P$1> = P$1 extends RaycastableRepresentation ? Partial<PointerEventHandlers> : unknown;
+type EventProps<P> = P extends RaycastableRepresentation ? Partial<PointerEventHandlers> : unknown;
 interface VueProps {
   children?: VNode[];
   ref?: VNodeRef;
   key?: string | number | symbol;
 }
-type ElementProps<T extends ConstructorRepresentation, P$1 = InstanceType<T>> = Partial<Overwrite<P$1, WithMathProps<P$1> & VueProps & EventProps<P$1>>>;
+type ElementProps<T extends ConstructorRepresentation, P = InstanceType<T>> = Partial<Overwrite<P, WithMathProps<P> & VueProps & EventProps<P>>>;
 type ThreeElement<T extends ConstructorRepresentation> = Mutable<Overwrite<ElementProps<T>, Omit<InstanceProps<InstanceType<T>, T>, 'object'>>>;
 type ThreeExports = typeof THREE;
 type ThreeInstancesImpl = { [K in keyof ThreeExports as Uncapitalize<K>]: ThreeExports[K] extends ConstructorRepresentation ? ThreeElement<ThreeExports[K]> : never };
@@ -499,7 +499,7 @@ declare function buildGraph(object: Object3D | TresObject): TresObjectMap;
 //#endregion
 //#region src/composables/useLoader/component.vue.d.ts
 declare const __VLS_export$1: <T extends TresObjectMap>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-  props: __VLS_PrettifyLocal<{
+  props: vue9.PublicProps & __VLS_PrettifyLocal<{
     /**
      * The THREE.js loader to use
      */
@@ -515,27 +515,27 @@ declare const __VLS_export$1: <T extends TresObjectMap>(__VLS_props: NonNullable
   } & {
     onLoaded?: ((result: T) => any) | undefined;
     onError?: ((error: unknown) => any) | undefined;
-  }> & vue0.PublicProps & (typeof globalThis extends {
+  }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
   expose: (exposed: {}) => void;
   attrs: any;
   slots: {
     default?: (props: {
-      state: vue0.UnwrapRef<T>;
+      state: vue9.UnwrapRef<T>;
       isLoading: boolean;
       error: unknown;
     }) => any;
   };
   emit: ((evt: "loaded", result: T) => void) & ((evt: "error", error: unknown) => void);
-}>) => vue0.VNode & {
+}>) => vue9.VNode & {
   __ctx?: Awaited<typeof __VLS_setup>;
 };
 declare const _default$1: typeof __VLS_export$1;
 type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
 //#region src/composables/useGraph/index.d.ts
-declare const useGraph: (object: MaybeRef$1<TresObject | undefined>) => vue0.ComputedRef<TresObjectMap | undefined>;
+declare const useGraph: (object: MaybeRef$1<TresObject | undefined>) => vue9.ComputedRef<TresObjectMap | undefined>;
 //#endregion
 //#region src/utils/createPriorityEventHook.d.ts
 type Callback<T> = Parameters<EventHookOff<T>>[0];
@@ -586,12 +586,17 @@ type LoopContext = RafLoopContext & TresPartialContext;
 declare const useLoop: () => {
   stop: () => void;
   start: () => void;
-  isActive: Readonly<vue0.ShallowRef<boolean>>;
+  isActive: Readonly<vue9.ShallowRef<boolean>>;
   onBeforeRender: PriorityEventHookOn<LoopContext>;
   onRender: PriorityEventHookOn<LoopContext>;
   render: (fn: RenderFunction) => void;
 };
 //#endregion
+//#region src/core/nodeOps.d.ts
+interface TresCustomRendererOptions {
+  primitivePrefix?: string;
+}
+//#endregion
 //#region src/utils/logger.d.ts
 /**
  * Logger utility for TresJS
@@ -644,8 +649,8 @@ declare const templateCompilerOptions: {
   };
 };
 //#endregion
-//#region src/components/TresCanvas.vue.d.ts
-interface TresCanvasProps extends RendererOptions {
+//#region src/components/Context.vue.d.ts
+interface ContextProps extends RendererOptions {
   /**
    * Custom camera instance to use as main camera
    * If not provided, a default PerspectiveCamera will be created
@@ -663,14 +668,23 @@ interface TresCanvasProps extends RendererOptions {
    * @default true
    */
   enableProvideBridge?: boolean;
+  /**
+   * Options for the TresJS custom renderer
+   *
+   */
+  customRendererOptions?: TresCustomRendererOptions;
 }
-type TresCanvasEmits = {
+type ContextEmits = {
   ready: [context: TresContext];
   pointermissed: [event: TresPointerEvent];
   render: [context: TresContext];
   beforeLoop: [context: TresContextWithClock];
   loop: [context: TresContextWithClock];
 } & { [key in TresPointerEventName]: [event: TresPointerEvent] };
+//#endregion
+//#region src/components/TresCanvas.vue.d.ts
+type TresCanvasEmits = ContextEmits;
+type TresCanvasProps = ContextProps;
 interface TresCanvasInstance {
   get context(): TresContext | undefined;
   dispose: () => void;
@@ -678,7 +692,7 @@ interface TresCanvasInstance {
 type __VLS_Slots = {
   default: () => any;
 };
-declare const __VLS_base: vue0.DefineComponent<TresCanvasProps, TresCanvasInstance, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {
+declare const __VLS_base: vue9.DefineComponent<ContextProps, TresCanvasInstance, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {
   click: (event: TresPointerEvent) => any;
   contextmenu: (event: TresPointerEvent) => any;
   pointermove: (event: TresPointerEvent) => any;
@@ -697,7 +711,7 @@ declare const __VLS_base: vue0.DefineComponent<TresCanvasProps, TresCanvasInstan
   render: (context: TresContext) => any;
   beforeLoop: (context: TresContextWithClock) => any;
   loop: (context: TresContextWithClock) => any;
-}, string, vue0.PublicProps, Readonly<TresCanvasProps> & Readonly<{
+}, string, vue9.PublicProps, Readonly<ContextProps> & Readonly<{
   onClick?: ((event: TresPointerEvent) => any) | undefined;
   onContextmenu?: ((event: TresPointerEvent) => any) | undefined;
   onPointermove?: ((event: TresPointerEvent) => any) | undefined;
@@ -718,6 +732,7 @@ declare const __VLS_base: vue0.DefineComponent<TresCanvasProps, TresCanvasInstan
   onLoop?: ((context: TresContextWithClock) => any) | undefined;
 }>, {
   windowSize: boolean;
+  enableProvideBridge: boolean;
   antialias: boolean;
   stencil: boolean;
   depth: boolean;
@@ -732,8 +747,7 @@ declare const __VLS_base: vue0.DefineComponent<TresCanvasProps, TresCanvasInstan
   shadowMapType: THREE.ShadowMapType;
   useLegacyLights: boolean;
   renderMode: "always" | "on-demand" | "manual";
-  enableProvideBridge: boolean;
-}, {}, {}, {}, string, vue0.ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, vue9.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 type __VLS_WithSlots<T, S> = T & {
@@ -1067,4 +1081,4 @@ interface TresPlugin {
 }
 declare const plugin: TresPlugin;
 //#endregion
-export { Args, AssetLoadData, AttachFnType, AttachType, ConstructorRepresentation, DevtoolsMessage, DevtoolsMessageType, DevtoolsMessenger, DevtoolsSubscriber, DisposeType, ElementProps, InstanceProps, LoaderMethods, LoaderProto, LocalState, LoopContext, MathType, Mutable, NonFunctionKeys, Overwrite, Properties, RenderFunction, RenderMode, RendererOptions, ThreeElement, ThreeInstances, TresCamera, _default as TresCanvas, type TresCanvasEmits, type TresCanvasInstance, type TresCanvasProps, TresCatalogue, TresColor, TresColorArray, type TresContext, TresContextWithClock, TresControl, TresEuler, TresInstance, TresLayers, TresLoader, TresLoaderOptions, TresMaterial, TresObject, TresObject3D, TresObjectMap, TresOptions, TresPartialContext, TresPlugin, type TresPointerEvent, TresPrimitive, TresQuaternion, TresRenderer, TresRendererSetupContext, TresScene, TresVector2, TresVector3, TresVector4, UseCameraReturn, _default$1 as UseLoader, UseLoaderReturn, UseRendererManagerReturn, UseRendererOptions, VectorCoordinates, type VectorFlexibleParams, VueProps, WithMathProps, buildGraph, catalogue, plugin as default, disposeObject3D as dispose, extend, isBufferGeometry, isCamera, isClassInstance, isColor, isColorRepresentation, isCopyable, isFog, isGroup, isLayers, isLight, isMaterial, isMesh, isObject3D, isOrthographicCamera, isPerspectiveCamera, isProd, isScene, isTresCamera, isTresInstance, isTresObject, isTresPrimitive, isVectorLike, logError, logMessage, logWarning, normalizeColor, normalizeVectorFlexibleParam, registerTresDevtools, templateCompilerOptions, useCameraManager, useGraph, useLoader, useLoop, useRendererManager, useTres, useTresContext, useTresContextProvider, vDistanceTo, vLightHelper, vLog };
+export { Args, AssetLoadData, AttachFnType, AttachType, ConstructorRepresentation, DevtoolsMessage, DevtoolsMessageType, DevtoolsMessenger, DevtoolsSubscriber, DisposeType, ElementProps, InstanceProps, LoaderMethods, LoaderProto, LocalState, LoopContext, MathType, Mutable, NonFunctionKeys, Overwrite, Properties, RenderFunction, RenderMode, RendererOptions, ThreeElement, ThreeInstances, TresCamera, _default as TresCanvas, type TresCanvasEmits, type TresCanvasInstance, type TresCanvasProps, TresCatalogue, TresColor, TresColorArray, TresComponents, type TresContext, TresContextWithClock, TresControl, type TresCustomRendererOptions, TresEuler, TresInstance, TresLayers, TresLoader, TresLoaderOptions, TresMaterial, TresObject, TresObject3D, TresObjectMap, TresOptions, TresPartialContext, TresPlugin, type TresPointerEvent, TresPrimitive, TresQuaternion, TresRenderer, TresRendererSetupContext, TresScene, TresVector2, TresVector3, TresVector4, UseCameraReturn, _default$1 as UseLoader, UseLoaderReturn, UseRendererManagerReturn, UseRendererOptions, VectorCoordinates, type VectorFlexibleParams, VueProps, WithMathProps, buildGraph, catalogue, plugin as default, disposeObject3D as dispose, extend, isBufferGeometry, isCamera, isClassInstance, isColor, isColorRepresentation, isCopyable, isFog, isGroup, isLayers, isLight, isMaterial, isMesh, isObject3D, isOrthographicCamera, isPerspectiveCamera, isProd, isScene, isTresCamera, isTresInstance, isTresObject, isTresPrimitive, isVectorLike, logError, logMessage, logWarning, normalizeColor, normalizeVectorFlexibleParam, registerTresDevtools, templateCompilerOptions, useCameraManager, useGraph, useLoader, useLoop, useRendererManager, useTres, useTresContext, useTresContextProvider, vDistanceTo, vLightHelper, vLog };

package/dist/tres.js

@@ -1,7 +1,7 @@
 /**
   * name: @tresjs/core
-  * version: v5.2.1
-  * (c) 2025
+  * version: v5.3.1
+  * (c) 2026
   * description: Declarative ThreeJS using Vue Components
   * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
   */
@@ -14,7 +14,7 @@ import { forwardHtmlEvents, getVoidObject } from "@pmndrs/pointer-events";
 import { setupDevtoolsPlugin } from "@vue/devtools-api";
 
 //#region package.json
-var version = "5.2.1";
+var version = "5.3.1";
 
 //#endregion
 //#region src/utils/makeMap.ts
@@ -1072,7 +1072,7 @@ const isSupportedPointerEvent = (event) => supportedPointerEvents.includes(event
 
 //#endregion
 //#region src/core/nodeOps.ts
-const nodeOps = (context) => {
+const nodeOps = ({ context, options = { primitivePrefix: "" } }) => {
 	const scene = context.scene.value;
 	function createElement(tag, _isSVG, _anchor, props) {
 		if (!props) props = {};
@@ -1081,7 +1081,7 @@ const nodeOps = (context) => {
 		if (tag.includes("-")) tag = tag.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).replace(/^[a-z]/, (c) => c.toUpperCase());
 		let name = tag.replace("Tres", "");
 		let obj;
-		if (tag === "primitive") {
+		if (tag === `${options?.primitivePrefix ?? ""}primitive`) {
 			if (!isObject(props.object) || isRef(props.object)) logError("Tres primitives need an 'object' prop, whose value is an object or shallowRef<object>");
 			name = props.object.type;
 			const __tres = {};
@@ -1825,6 +1825,10 @@ var Context_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ define
 			type: Boolean,
 			required: false
 		},
+		customRendererOptions: {
+			type: Object,
+			required: false
+		},
 		antialias: {
 			type: Boolean,
 			required: false
@@ -1967,7 +1971,10 @@ var Context_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ define
 		} });
 		const mountCustomRenderer = (context$1, empty = false) => {
 			const InternalComponent = createInternalComponent(context$1, empty);
-			const { render } = createRenderer(nodeOps(context$1));
+			const { render } = createRenderer(nodeOps({
+				context: context$1,
+				options: props.customRendererOptions
+			}));
 			render(h(InternalComponent), scene.value);
 		};
 		const dispose = (context$1, force = false) => {
@@ -2078,6 +2085,10 @@ var TresCanvas_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ def
 			required: false,
 			default: true
 		},
+		customRendererOptions: {
+			type: Object,
+			required: false
+		},
 		antialias: {
 			type: Boolean,
 			required: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tresjs/core",
   "type": "module",
-  "version": "5.2.1",
+  "version": "5.3.1",
   "description": "Declarative ThreeJS using Vue Components",
   "author": "Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)",
   "license": "MIT",
@@ -67,7 +67,7 @@
     "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-visualizer": "^6.0.3",
     "three": "^0.180.0",
-    "tsdown": "0.16.1",
+    "tsdown": "0.18.3",
     "typescript": "^5.8.3",
     "vite": "^7.1.9",
     "vite-plugin-banner": "^0.8.1",
@@ -76,7 +76,7 @@
     "vitest": "3.2.4",
     "vue": "^3.5.22",
     "vue-demi": "^0.14.10",
-    "vue-tsc": "^3.1.1",
+    "vue-tsc": "^3.2.1",
     "@tresjs/eslint-config": "1.5.1"
   },
   "nx": {

package/dist/chunk-BRx1-uMz.js

@@ -1,30 +0,0 @@
-/**
-  * name: @tresjs/core
-  * version: v5.2.1
-  * (c) 2025
-  * description: Declarative ThreeJS using Vue Components
-  * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
-  */
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion