@tresjs/cientos 3.3.0 → 3.4.1

package/README.md

@@ -87,4 +87,4 @@ pnpm run docs:build
 
 ## Sponsors
 
-Be the first to support this project [here](https://github.com/sponsors/alvarosabu) ☺️
+Be the first to support this project [here](https://github.com/sponsors/alvarosabu) ☺️.

package/dist/core/abstractions/Lensflare/RandUtils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Seedable pseudorandom number tools
+ */
+export default class RandUtils {
+    private _getNext;
+    private _getGenerator;
+    /**
+     * Create a new seeded pseudorandom number generator.
+     * @param [seed=0] - the seed for the generator
+     * @param [getSeededRandomGenerator=getMulberry32] - a function that returns a pseudorandom number generator
+     * @constructor
+     */
+    constructor(seed?: number, getSeededRandomGenerator?: (seed: number) => () => number);
+    /**
+     * Reseed the pseudorandom number generator
+     */
+    seed(s: number): void;
+    /**
+     * Return the next pseudorandom number in the interval [0, 1]
+     */
+    rand(): number;
+    /**
+     * Random float from <low, high> interval
+     * @param low - Low value of the interval
+     * @param high - High value of the interval
+     */
+    float(low: number, high: number): number;
+    /**
+     * Random float from <-range/2, range/2> interval
+     * @param range - Interval range
+     */
+    floatSpread(range: number): number;
+    /**
+     * Random integer from <low, high> interval
+     * @param low Low value of the interval
+     * @param high High value of the interval
+     */
+    int(low: number, high: number): number;
+    /**
+     * Choose an element from an array.
+     * @param array The array to choose from
+     * @returns An element from the array or null if the array is empty
+     */
+    choice<T>(array: T[]): T | null;
+    /**
+     * Choose an element from an array or return defaultValue if array is empty.
+     * @param array The array to choose from
+     * @param defaultValue The value to return if the array is empty
+     * @returns An element from the array or defaultValue if the array is empty
+     */
+    defaultChoice<T>(array: T[], defaultValue: T): T;
+    /**
+     * Return n elements from an array.
+     * @param array The array to sample
+     * @param sampleSizeMin The minimum sample size
+     * @param sampleSizeMax The maximum sample size
+     */
+    sample<T>(array: T[], sampleSizeMin: number, sampleSizeMax?: number): T[];
+    /**
+     * Shuffle an array. Not in-place.
+     * @param array The array to shuffle
+     */
+    shuffle<T>(array: T[]): T[];
+    /**
+     * The default pseudorandom generator.
+     */
+    private getMulberry32;
+}

package/dist/core/abstractions/Lensflare/component.vue.d.ts

@@ -0,0 +1,69 @@
+import { Lensflare } from 'three/examples/jsm/objects/Lensflare';
+import type { LensflareElementProps, SeedProps } from '.';
+declare const _default: import("vue").DefineComponent<{
+    color: {
+        type: import("vue").PropType<import("three").ColorRepresentation | [r: number, g: number, b: number]>;
+    };
+    texture: {
+        type: import("vue").PropType<string | import("three").Texture>;
+    };
+    scale: {
+        type: import("vue").PropType<number>;
+        default: number;
+    };
+    elements: {
+        type: import("vue").PropType<Partial<LensflareElementProps>[]>;
+        default: undefined;
+    };
+    size: {
+        type: import("vue").PropType<number>;
+    };
+    distance: {
+        type: import("vue").PropType<number>;
+    };
+    seed: {
+        type: import("vue").PropType<number>;
+        default: undefined;
+    };
+    seedProps: {
+        type: import("vue").PropType<SeedProps[]>;
+        default: undefined;
+    };
+}, {
+    value: import("vue").ShallowRef<Lensflare | undefined>;
+}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    color: {
+        type: import("vue").PropType<import("three").ColorRepresentation | [r: number, g: number, b: number]>;
+    };
+    texture: {
+        type: import("vue").PropType<string | import("three").Texture>;
+    };
+    scale: {
+        type: import("vue").PropType<number>;
+        default: number;
+    };
+    elements: {
+        type: import("vue").PropType<Partial<LensflareElementProps>[]>;
+        default: undefined;
+    };
+    size: {
+        type: import("vue").PropType<number>;
+    };
+    distance: {
+        type: import("vue").PropType<number>;
+    };
+    seed: {
+        type: import("vue").PropType<number>;
+        default: undefined;
+    };
+    seedProps: {
+        type: import("vue").PropType<SeedProps[]>;
+        default: undefined;
+    };
+}>>, {
+    scale: number;
+    elements: Partial<LensflareElementProps>[];
+    seed: number;
+    seedProps: SeedProps[];
+}, {}>;
+export default _default;

package/dist/core/abstractions/Lensflare/constants.d.ts

@@ -0,0 +1,20 @@
+import type { LensflareElementProps, SeedProps } from '.';
+export declare const TEXTURE_PATH = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/";
+export declare const circle = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/circle.png";
+export declare const circleBlur = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/circleBlur.png";
+export declare const circleRainbow = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/circleRainbow.png";
+export declare const line = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/line.png";
+export declare const poly6 = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/poly6.png";
+export declare const polyStroke6 = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/polyStroke6.png";
+export declare const rays = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/rays.png";
+export declare const ring = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/ring.png";
+export declare const starThin6 = "https://raw.githubusercontent.com/Tresjs/assets/93976c7d63ac83d4a254a41a10b2362bc17e90c9/textures/lensflare/starThin6.png";
+export declare const oversize: SeedProps;
+export declare const bodyRequired0: SeedProps;
+export declare const bodyRequired1: SeedProps;
+export declare const bodyOptional: SeedProps;
+export declare const darkPurple: number, darkBlue: number;
+export declare const front: SeedProps;
+export declare const back: SeedProps;
+export declare const defaultSeedProps: SeedProps[];
+export declare const defaultLensflareElementProps: LensflareElementProps;

package/dist/core/abstractions/Lensflare/index.d.ts

@@ -0,0 +1,36 @@
+import type { Texture } from 'three';
+import type { TresColor } from '@tresjs/core';
+import Lensflare from './component.vue';
+export { Lensflare };
+export interface SeedProps {
+    texture: string[];
+    color: TresColor[];
+    distance: [number, number];
+    size: [number, number];
+    length: [number, number];
+    seed?: number;
+}
+/**
+ * To make creating a complex lensflare simpler, the component can generate some or all `LensflareElement` properties.
+ * The precendence in creating the final elements' props is as follows:
+ *
+ * 1. `elements`
+ * 2. `userDefaultElement` - `color`, `distance`, `size`, `texture` from component
+ * 3. seeded random props - if `seed` and/or `seedProps` is not `undefined`
+ * 4. system default
+ *
+ * @param elements - `undefined` or an array of (potentially) incomplete element props
+ * @param userDefaultElement - values to "fill in" missing partial elements fields – or overwrite seeded props
+ * @param seed - `undefined` or a number to seed random prop generation
+ * @param seedProps - `undefined` or an array of SeedProps for generating random seeded properties
+ * @param systemDefaultElement - default values to "fill in" any remaining missing props
+ * @returns LensflareElementProps[] - An array of complete props
+ **/
+export declare const partialLensflarePropsArrayToLensflarePropsArray: (elements: Partial<LensflareElementProps>[] | undefined, userDefaultElement: Partial<LensflareElementProps>, seed?: number | undefined, seedProps?: SeedProps[] | undefined, systemDefaultElement?: LensflareElementProps) => LensflareElementProps[];
+export interface LensflareElementProps {
+    texture: Texture | string;
+    size: number;
+    distance: number;
+    color: TresColor;
+}
+export declare function filterLensflareElementProps(props: Partial<LensflareElementProps>): Partial<LensflareElementProps>;

package/dist/core/abstractions/index.d.ts

@@ -2,5 +2,6 @@ import Text3D from './Text3D.vue';
 import { useAnimations } from './useAnimations';
 import Levioso from './Levioso.vue';
 import MouseParallax from './MouseParallax.vue';
+import Lensflare from './Lensflare/component.vue';
 export * from '../staging/useEnvironment';
-export { Text3D, useAnimations, MouseParallax, Levioso, };
+export { Text3D, useAnimations, MouseParallax, Levioso, Lensflare, };