build-examples: Support namespaced modules

[marcofugaro]

Related issue: Fixes #22267 (comment)

Description

Add support for namespaced modules in the build-examples script.

Basically this

export {
	computeTangents,
	mergeBufferGeometries,
	mergeBufferAttributes,
	interleaveAttributes,
	estimateBytesUsed,
	mergeVertices,
	toTrianglesDrawMode,
	computeMorphedAttributes,
};

becomes this

THREE.BufferGeometryUtils = {};
THREE.BufferGeometryUtils.computeMorphedAttributes = computeMorphedAttributes;
THREE.BufferGeometryUtils.computeTangents = computeTangents;
THREE.BufferGeometryUtils.estimateBytesUsed = estimateBytesUsed;
THREE.BufferGeometryUtils.interleaveAttributes = interleaveAttributes;
THREE.BufferGeometryUtils.mergeBufferAttributes = mergeBufferAttributes;
THREE.BufferGeometryUtils.mergeBufferGeometries = mergeBufferGeometries;
THREE.BufferGeometryUtils.mergeVertices = mergeVertices;
THREE.BufferGeometryUtils.toTrianglesDrawMode = toTrianglesDrawMode;

I had to add an array to keep track of modules that need to be namespaced, otherwise, there is no way to tell.

[mrdoob]

Hmm... Is it possible use dynamic imports in the script to see what it exports?

const module = await import('./foo.js');
console.log( module );

[marcofugaro]

@mrdoob to check that there is more than 1 export?

[mrdoob]

Yes, and if there is a default one.

[marcofugaro]

@mrdoob I thought about doing so, but there are some exceptions that prevents this 😅

Currently CameraControls, TransformControls, Geometry, DecalGeometry, VOXLoader, Lut, RollerCoaster, CurveModifier, Lensflare, MarchingCubes, Pass, CSS3DRenderer, CSS2DRenderer, Projector, BokehShader2, DepthLimitedBlurShader, GodRaysShader, SMAAShader, SSAOShader, SSRrShader, SSRShader, ToonShader all export multiple things, and they don't need to be under a namespace.

We need a way to differentiate between modules that export multiple things and modules that need a namespace.

I am doing this with const namespaces = [ 'BufferGeometryUtils' ]; because I couldn't find a better way 😄

[marcofugaro]

I could namespace only the modules that end with Utils 🤔

[marcofugaro]

@mrdoob done! Now all the files that end with Utils.js are automatically namespaced.

If we merge this and #22284 everything should work fine again!

[mrdoob]

Thanks!