@defold-typescript/types 0.38.0 → 0.40.0

package/generated/versions/defold-1.13.0/b2d_shape.d.ts

@@ -47,6 +47,7 @@ declare global {
      * @returns true if contact events are enabled
      */
     function are_contact_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    function are_contact_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if hit events are enabled for a shape.
      *
@@ -54,6 +55,7 @@ declare global {
      * @returns true if hit events are enabled
      */
     function are_hit_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    function are_hit_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if pre-solve events are enabled for a shape.
      *
@@ -61,6 +63,7 @@ declare global {
      * @returns true if pre-solve events are enabled
      */
     function are_pre_solve_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    function are_pre_solve_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if sensor events are enabled for a shape.
      *
@@ -68,6 +71,7 @@ declare global {
      * @returns true if sensor events are enabled
      */
     function are_sensor_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    function are_sensor_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Enable or disable contact events for a shape.
      *
@@ -75,6 +79,7 @@ declare global {
      * @param enable - true to enable contact events
      */
     function enable_contact_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    function enable_contact_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable hit events for a shape.
      *
@@ -82,6 +87,7 @@ declare global {
      * @param enable - true to enable hit events
      */
     function enable_hit_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    function enable_hit_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable pre-solve events for a shape.
      *
@@ -89,6 +95,7 @@ declare global {
      * @param enable - true to enable pre-solve events
      */
     function enable_pre_solve_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    function enable_pre_solve_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable sensor events for a shape.
      *
@@ -96,6 +103,7 @@ declare global {
      * @param enable - true to enable sensor events
      */
     function enable_sensor_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    function enable_sensor_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Get the body owning a shape.
      *
@@ -103,6 +111,7 @@ declare global {
      * @returns owning body
      */
     function get_body(shape_id: Opaque<"b2Shape">): Opaque<"b2Body">;
+    function get_body(body: Opaque<"b2Body">, shape_index: number): Opaque<"b2Body">;
     /**
      * Get the closest point on a shape.
      *
@@ -111,6 +120,7 @@ declare global {
      * @returns closest world point on the shape
      */
     function get_closest_point(shape_id: Opaque<"b2Shape">, target: Vector3): Vector3;
+    function get_closest_point(body: Opaque<"b2Body">, shape_index: number, target: Vector3): Vector3;
     /**
      * Get shape contact capacity.
      *
@@ -118,6 +128,7 @@ declare global {
      * @returns maximum contact data count
      */
     function get_contact_capacity(shape_id: Opaque<"b2Shape">): number;
+    function get_contact_capacity(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get touching contact data for a shape.
      *
@@ -125,6 +136,7 @@ declare global {
      * @returns array of contact tables
      */
     function get_contact_data(shape_id: Opaque<"b2Shape">): Record<string | number, unknown>;
+    function get_contact_data(body: Opaque<"b2Body">, shape_index: number): Record<string | number, unknown>;
     /**
      * Get mass data for a shape.
      *
@@ -132,6 +144,7 @@ declare global {
      * @returns table with `mass`, `center`, and `inertia`
      */
     function get_mass_data(shape_id: Opaque<"b2Shape">): { mass: number; center: Vector3; inertia: number };
+    function get_mass_data(body: Opaque<"b2Body">, shape_index: number): { mass: number; center: Vector3; inertia: number };
     /**
      * Get shape material id.
      *
@@ -139,6 +152,7 @@ declare global {
      * @returns shape material id
      */
     function get_material(shape_id: Opaque<"b2Shape">): number;
+    function get_material(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get sensor overlap capacity.
      *
@@ -146,6 +160,7 @@ declare global {
      * @returns maximum sensor overlap count
      */
     function get_sensor_capacity(shape_id: Opaque<"b2Shape">): number;
+    function get_sensor_capacity(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get sensor overlaps.
      *
@@ -153,6 +168,7 @@ declare global {
      * @returns array of shape info tables
      */
     function get_sensor_overlaps(shape_id: Opaque<"b2Shape">): { shape_id: number }[];
+    function get_sensor_overlaps(body: Opaque<"b2Body">, shape_index: number): { shape_id: number }[];
     /**
      * Get a shape's geometry.
      *
@@ -160,6 +176,7 @@ declare global {
      * @returns shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
      */
     function get_shape(shape_id: Opaque<"b2Shape">): { type: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 };
+    function get_shape(body: Opaque<"b2Body">, shape_index: number): { type: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 };
     /**
      * Get the world owning a shape.
      *
@@ -167,6 +184,7 @@ declare global {
      * @returns owning world
      */
     function get_world(shape_id: Opaque<"b2Shape">): Opaque<"b2World">;
+    function get_world(body: Opaque<"b2Body">, shape_index: number): Opaque<"b2World">;
     /**
      * Validate a shape handle.
      *
@@ -174,6 +192,7 @@ declare global {
      * @returns true if the shape handle still refers to a live Box2D shape
      */
     function is_valid(shape_id: Opaque<"b2Shape">): boolean;
+    function is_valid(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Ray cast a shape directly.
      *
@@ -184,6 +203,7 @@ declare global {
      * @returns hit table with `point`, `normal`, `fraction`, and `iterations`, or nil
      */
     function ray_cast(shape_id: Opaque<"b2Shape">, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number };
+    function ray_cast(body: Opaque<"b2Body">, shape_index: number, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number };
     /**
      * Set shape material id.
      *
@@ -191,6 +211,7 @@ declare global {
      * @param material - shape material id
      */
     function set_material(shape_id: Opaque<"b2Shape">, material: number): void;
+    function set_material(body: Opaque<"b2Body">, shape_index: number, material: number): void;
     /**
      * This updates the shape geometry using the same table format as
      * `b2d.body.create_shape` and `b2d.shape.get_shape`. The body mass is not
@@ -210,7 +231,8 @@ declare global {
      * }
      * ```
      */
-    function set_shape(shape_id: Opaque<"b2Shape">, definition: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass: boolean): void;
+    function set_shape(shape_id: Opaque<"b2Shape">, definition: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;
+    function set_shape(body: Opaque<"b2Body">, shape_index: number, definition: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;
   }
 }
 

package/generated/versions/defold-1.13.0/buffer.d.ts

@@ -6,6 +6,7 @@ declare global {
    * Functions for manipulating buffers and streams
    */
   namespace buffer {
+    type ValueType = typeof buffer.VALUE_TYPE_FLOAT32 | typeof buffer.VALUE_TYPE_INT16 | typeof buffer.VALUE_TYPE_INT32 | typeof buffer.VALUE_TYPE_INT64 | typeof buffer.VALUE_TYPE_INT8 | typeof buffer.VALUE_TYPE_UINT16 | typeof buffer.VALUE_TYPE_UINT32 | typeof buffer.VALUE_TYPE_UINT64 | typeof buffer.VALUE_TYPE_UINT8;
     /**
      * Float, single precision, 4 bytes
      */
@@ -56,11 +57,15 @@ declare global {
      * @example
      * ```ts
      * // How to copy elements (e.g. vertices) from one buffer to another
+     * const element_count = 64;
+     * const srcbuffer = resource.get_buffer("/src.bufferc");
+     * const dstbuffer = resource.get_buffer("/dst.bufferc");
+     *
      * // copy entire buffer
-     * buffer.copy_buffer(dstbuffer, 0, srcbuffer, 0, srcbuffer.length);
+     * buffer.copy_buffer(dstbuffer, 0, srcbuffer, 0, element_count);
      *
      * // copy last 10 elements to the front of another buffer
-     * buffer.copy_buffer(dstbuffer, 0, srcbuffer, srcbuffer.length - 10, 10);
+     * buffer.copy_buffer(dstbuffer, 0, srcbuffer, element_count - 10, 10);
      * ```
      */
     function copy_buffer(dst: Opaque<"buffer">, dstoffset: number, src: Opaque<"buffer">, srcoffset: number, count: number): void;
@@ -77,13 +82,16 @@ declare global {
      * @example
      * ```ts
      * // How to update a texture of a sprite:
+     * const srcbuffer = resource.get_buffer("/src.bufferc");
+     * const dstbuffer = resource.get_buffer("/dst.bufferc");
+     *
      * // copy entire stream
      * const srcstream = buffer.get_stream(srcbuffer, hash("xyz"));
      * const dststream = buffer.get_stream(dstbuffer, hash("xyz"));
-     * buffer.copy_stream(dststream, 0, srcstream, 0, srcstream.length);
+     * buffer.copy_stream(dststream, 0, srcstream, 0, srcstream.length());
      * ```
      */
-    function copy_stream(dst: Opaque<"bufferstream"> & { [index: number]: number }, dstoffset: number, src: Opaque<"bufferstream"> & { [index: number]: number }, srcoffset: number, count: number): void;
+    function copy_stream(dst: Opaque<"bufferstream"> & { [index: number]: number; length: LuaLengthMethod<number> }, dstoffset: number, src: Opaque<"bufferstream"> & { [index: number]: number; length: LuaLengthMethod<number> }, srcoffset: number, count: number): void;
     /**
      * Create a new data buffer containing a specified set of streams. A data buffer
      * can contain one or more streams with typed data. This is useful for managing
@@ -103,24 +111,27 @@ declare global {
      * ```ts
      * // How to create and initialize a buffer
      * export default defineScript({
-     *   init(self) {
+     *   init() {
      *     const size = 128;
-     *     self.image = buffer.create(size * size, [{ name: hash("rgb"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);
-     *     self.imagestream = buffer.get_stream(self.image, hash("rgb"));
-     *
-     *     for (let y = 0; y < self.height; y++) {
-     *       for (let x = 0; x < self.width; x++) {
-     *         const index = y * self.width * 3 + x * 3;
-     *         self.imagestream[index + 0] = self.r;
-     *         self.imagestream[index + 1] = self.g;
-     *         self.imagestream[index + 2] = self.b;
+     *     const [width, height] = [size, size];
+     *     const [r, g, b] = [0xff, 0x80, 0x10];
+     *     const image = buffer.create(size * size, [{ name: hash("rgb"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);
+     *     const imagestream = buffer.get_stream(image, hash("rgb"));
+     *
+     *     for (let y = 0; y < height; y++) {
+     *       for (let x = 0; x < width; x++) {
+     *         const index = y * width * 3 + x * 3;
+     *         imagestream[index + 0] = r;
+     *         imagestream[index + 1] = g;
+     *         imagestream[index + 2] = b;
      *       }
      *     }
+     *     return { image, imagestream };
      *   },
      * });
      * ```
      */
-    function create(element_count: number, declaration: { name?: Hash | string; type?: Opaque<"constant">; count?: number }): Opaque<"buffer">;
+    function create(element_count: number, declaration: { name?: Hash | string; type?: buffer.ValueType; count?: number }[]): Opaque<"buffer">;
     /**
      * Get a copy of all the bytes from a specified stream as a Lua string.
      *
@@ -128,7 +139,7 @@ declare global {
      * @param stream_name - the name of the stream
      * @returns the buffer data as a Lua string
      */
-    function get_bytes(buffer: Opaque<"buffer">, stream_name: Hash): string;
+    function get_bytes(buffer: Opaque<"buffer">, stream_name: Hash | string): string;
     /**
      * Get a named metadata entry from a buffer along with its type.
      *
@@ -137,12 +148,14 @@ declare global {
      * @example
      * ```ts
      * // How to get a metadata entry from a buffer
+     * const buf = resource.get_buffer("/my.bufferc");
+     *
      * // retrieve a metadata entry named "somefloats" and its numeric type
      * const [values, type] = buffer.get_metadata(buf, hash("somefloats"));
      * if (values) print(`${values.length} values in 'somefloats'`);
      * ```
      */
-    function get_metadata(buf: Opaque<"buffer">, metadata_name: Hash | string): LuaMultiReturn<[number[] | undefined, number & { readonly __brand: "buffer.VALUE_TYPE_FLOAT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT16" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT64" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT8" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT16" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT64" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT8" } | undefined]>;
+    function get_metadata(buf: Opaque<"buffer">, metadata_name: Hash | string): LuaMultiReturn<[number[] | undefined, buffer.ValueType | undefined]>;
     /**
      * Get a specified stream from a buffer.
      *
@@ -150,7 +163,7 @@ declare global {
      * @param stream_name - the stream name
      * @returns the data stream
      */
-    function get_stream(buffer: Opaque<"buffer">, stream_name: Hash | string): Opaque<"bufferstream"> & { [index: number]: number };
+    function get_stream(buffer: Opaque<"buffer">, stream_name: Hash | string): Opaque<"bufferstream"> & { [index: number]: number; length: LuaLengthMethod<number> };
     /**
      * Creates or updates a metadata array entry on a buffer.
      * The value type and count given when updating the entry should match those used when first creating it.
@@ -162,6 +175,8 @@ declare global {
      * @example
      * ```ts
      * // How to set a metadata entry on a buffer
+     * const buf = resource.get_buffer("/my.bufferc");
+     *
      * // create a new metadata entry with three floats
      * buffer.set_metadata(buf, hash("somefloats"), [1.5, 3.2, 7.9], buffer.VALUE_TYPE_FLOAT32);
      * // ...
@@ -169,7 +184,7 @@ declare global {
      * buffer.set_metadata(buf, hash("somefloats"), [-2.5, 10.0, 32.2], buffer.VALUE_TYPE_FLOAT32);
      * ```
      */
-    function set_metadata(buf: Opaque<"buffer">, metadata_name: Hash | string, values: number[], value_type: number & { readonly __brand: "buffer.VALUE_TYPE_FLOAT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT16" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT64" } | number & { readonly __brand: "buffer.VALUE_TYPE_INT8" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT16" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT32" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT64" } | number & { readonly __brand: "buffer.VALUE_TYPE_UINT8" }): void;
+    function set_metadata(buf: Opaque<"buffer">, metadata_name: Hash | string, values: number[], value_type: buffer.ValueType): void;
   }
 }
 

package/generated/versions/defold-1.13.0/camera.d.ts

@@ -47,6 +47,7 @@ declare global {
      * @returns a table with all camera URLs
      * @example
      * ```ts
+     * const predicate = render.predicate([hash("my_tag")]);
      * for (const camera_id of camera.get_cameras()) {
      *   render.set_camera(camera_id);
      *   render.draw(predicate);
@@ -136,7 +137,7 @@ declare global {
      * export default defineScript({
      *   on_input(self, action_id, action) {
      *     if (action_id === hash("touch")) {
-     *       if (action.pressed) {
+     *       if (action.pressed && action.screen_x !== undefined && action.screen_y !== undefined) {
      *         const perspective_camera = msg.url("#perspective_camera");
      *         const random_z = math.random(
      *           camera.get_near_z(perspective_camera) + 0.01,
@@ -168,7 +169,7 @@ declare global {
      * export default defineScript({
      *   on_input(self, action_id, action) {
      *     if (action_id === hash("touch")) {
-     *       if (action.pressed) {
+     *       if (action.pressed && action.screen_x !== undefined && action.screen_y !== undefined) {
      *         const world_position = camera.screen_xy_to_world(action.screen_x, action.screen_y);
      *         go.set_position(world_position, "/go1");
      *       }

package/generated/versions/defold-1.13.0/collectionfactory.d.ts

@@ -7,6 +7,7 @@ declare global {
    * used to dynamically spawn collections into the runtime.
    */
   namespace collectionfactory {
+    type Status = typeof collectionfactory.STATUS_UNLOADED | typeof collectionfactory.STATUS_LOADING | typeof collectionfactory.STATUS_LOADED;
     /**
      * loaded
      */
@@ -45,18 +46,17 @@ declare global {
      * ```ts
      * // How to spawn a collection of game objects:
      * export default defineScript({
-     *   init(self) {
+     *   init() {
      *     // Spawn a small group of enemies.
      *     const pos = vmath.vector3(100, 12.5, 0);
      *     const rot = vmath.quat_rotation_z(Math.PI / 2);
      *     const scale = 0.5;
-     *     const props = {
-     *       [hash("/enemy_leader")]: { health: 1000.0 },
-     *       [hash("/enemy_1")]: { health: 200.0 },
-     *       [hash("/enemy_2")]: { health: 400.0, color: hash("green") },
-     *     };
+     *     const props = new LuaMap<Hash, Record<string, unknown>>();
+     *     props.set(hash("/enemy_leader"), { health: 1000.0 });
+     *     props.set(hash("/enemy_1"), { health: 200.0 });
+     *     props.set(hash("/enemy_2"), { health: 400.0, color: hash("green") });
      *
-     *     self.enemy_ids = collectionfactory.create("#enemyfactory", pos, rot, props, scale);
+     *     const enemy_ids = collectionfactory.create("#enemyfactory", pos, rot, props, scale);
      *     // enemy_ids now map to the spawned instance ids:
      *     //
      *     // pprint(self.enemy_ids)
@@ -69,16 +69,21 @@ declare global {
      *     // }
      *
      *     // Send "attack" message to the leader. First look up its instance id.
-     *     const leader_id = self.enemy_ids[hash("/enemy_leader")];
-     *     msg.post(leader_id, "attack");
+     *     const leader_id = enemy_ids.get(hash("/enemy_leader"));
+     *     if (leader_id !== undefined) {
+     *       msg.post(leader_id, "attack");
+     *     }
+     *     return { enemy_ids };
      *   },
      * });
      *
      * // How to delete a spawned collection:
-     * go.delete(self.enemy_ids);
+     * function delete_enemies(self: { enemy_ids: Hash[] }) {
+     *   go.delete(self.enemy_ids);
+     * }
      * ```
      */
-    function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: Record<string | number, unknown>, scale?: number | Vector3): LuaMap<Hash, Hash>;
+    function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: LuaMap<Hash, Record<string | number, unknown>> | Record<string, Record<string | number, unknown>>, scale?: number | Vector3): LuaMap<Hash, Hash>;
     /**
      * This returns status of the collection factory.
      * Calling this function when the factory is not marked as dynamic loading always returns COMP_COLLECTION_FACTORY_STATUS_LOADED.
@@ -92,7 +97,7 @@ declare global {
      *
      * - `collectionfactory.STATUS_LOADED`
      */
-    function get_status(url?: string | Hash | Url): number & { readonly __brand: "collectionfactory.STATUS_UNLOADED" } | number & { readonly __brand: "collectionfactory.STATUS_LOADING" } | number & { readonly __brand: "collectionfactory.STATUS_LOADED" };
+    function get_status(url?: string | Hash | Url): collectionfactory.Status;
     /**
      * Resources loaded are referenced by the collection factory component until the existing (parent) collection is destroyed or collectionfactory.unload is called.
      * Calling this function when the factory is not marked as dynamic loading does nothing.

package/generated/versions/defold-1.13.0/collectionproxy.d.ts

@@ -32,7 +32,7 @@ declare global {
      * collection was not excluded.
      * @example
      * ```ts
-     * function print_resources(self, cproxy) {
+     * function print_resources(self: unknown, cproxy: Url) {
      *   const resources = collectionproxy.get_resources(cproxy);
      *   for (const v of resources) {
      *     print(`Resource: ${v}`);

package/generated/versions/defold-1.13.0/compute.d.ts

@@ -299,7 +299,7 @@ declare global {
      * compute.set_textures("/my_compute.computec", { my_texture: resource.texture() });
      * ```
      */
-    function set_textures(path: Hash | string, textures: LuaMap<string, Hash>): void;
+    function set_textures(path: Hash | string, textures: LuaMap<string, Hash> | Record<string, Hash>): void;
   }
 }
 

package/generated/versions/defold-1.13.0/factory.d.ts

@@ -7,6 +7,7 @@ declare global {
    * dynamically spawn game objects into the runtime.
    */
   namespace factory {
+    type Status = typeof factory.STATUS_UNLOADED | typeof factory.STATUS_LOADING | typeof factory.STATUS_LOADED;
     /**
      * loaded
      */
@@ -71,7 +72,7 @@ declare global {
      *
      * - `factory.STATUS_LOADED`
      */
-    function get_status(url?: string | Hash | Url): number & { readonly __brand: "factory.STATUS_UNLOADED" } | number & { readonly __brand: "factory.STATUS_LOADING" } | number & { readonly __brand: "factory.STATUS_LOADED" };
+    function get_status(url?: string | Hash | Url): factory.Status;
     /**
      * Resources are referenced by the factory component until the existing (parent) collection is destroyed or factory.unload is called.
      * Calling this function when the factory is not marked as dynamic loading does nothing.