@canvasengine/presets 2.0.0-beta.51 → 2.0.0-beta.52

package/dist/NightAmbiant.d.ts

@@ -1,3 +1,143 @@
-export declare function LightSpot(opts: any): import('../packages/core/src/index.ts').Element<import('../packages/core/src/index.ts').ComponentInstance>;
-export declare function NightAmbiant(props: any): import('../packages/core/src/index.ts').Element<import('../packages/core/src/index.ts').ComponentInstance> | Promise<import('../packages/core/src/index.ts').Element<import('../packages/core/src/index.ts').ComponentInstance>>;
+import { Filter } from 'pixi.js';
+type PointLike = {
+    x: number;
+    y: number;
+};
+type BoundsLike = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type ScreenPointLike = {
+    x: number;
+    y: number;
+};
+type ReactiveValue<T> = T | (() => T);
+type ViewportLike = {
+    getVisibleBounds?: () => BoundsLike | null | undefined;
+    toScreen?: (x: number, y: number) => ScreenPointLike;
+    screenWidth?: number;
+    screenHeight?: number;
+};
+export type NightSpot = PointLike & {
+    radius?: number;
+    intensity?: number;
+    flicker?: boolean;
+    flickerSpeed?: number;
+    pulse?: boolean;
+    pulseSpeed?: number;
+    phase?: number;
+};
+export type NightSpotInput = {
+    x: ReactiveValue<number>;
+    y: ReactiveValue<number>;
+    radius?: ReactiveValue<number>;
+    intensity?: ReactiveValue<number>;
+    flicker?: ReactiveValue<boolean>;
+    flickerSpeed?: ReactiveValue<number>;
+    pulse?: ReactiveValue<boolean>;
+    pulseSpeed?: ReactiveValue<number>;
+    phase?: ReactiveValue<number>;
+};
+/**
+ * Color input type supporting hex string, number, or RGB array.
+ *
+ * @example
+ * ```ts
+ * // Hex string
+ * const color1: ColorInput = "#0a1020";
+ * // Number
+ * const color2: ColorInput = 0x0a1020;
+ * // RGB tuple (0-255)
+ * const color3: ColorInput = [10, 16, 32];
+ * // Normalized RGB (0-1)
+ * const color4: ColorInput = [0.04, 0.06, 0.12];
+ * ```
+ */
+export type ColorInput = string | number | [number, number, number];
+export type NightAmbiantProps = {
+    /** Main reactive list of light spots. */
+    lightSpots?: ReactiveValue<Array<NightSpotInput | NightSpot>>;
+    /** Alias for `lightSpots` for compatibility. */
+    spots?: ReactiveValue<Array<NightSpotInput | NightSpot>>;
+    /** Darkness intensity outside light spots (0 = no darkening, 1 = full black). Default: 0.75 */
+    darkness?: ReactiveValue<number>;
+    /** Tint color applied in dark zones. Default: "#000000" */
+    darkColor?: ReactiveValue<ColorInput>;
+    /** Fog color around light spots. Default: "#141424" */
+    fogColor?: ReactiveValue<ColorInput>;
+    /** Distance from light center where fog starts (0-1). Default: 0.5 */
+    fogRadius?: ReactiveValue<number>;
+    /** Width of the fog transition. Default: 0.35 */
+    fogSoftness?: ReactiveValue<number>;
+};
+export type NightFilter = Filter & {
+    setLightWorldPosition: (position: PointLike | null) => void;
+    getLightWorldPosition: () => PointLike | null;
+    setSpots: (spots: NightSpot[]) => void;
+    getSpots: () => NightSpot[];
+    syncLightToViewport: () => void;
+    setDarkness: (value: number) => void;
+    setDarkColor: (color: ColorInput) => void;
+    setFogColor: (color: ColorInput) => void;
+    setFogRadius: (value: number) => void;
+    setFogSoftness: (value: number) => void;
+};
+/**
+ * Creates a night filter with configurable light spots, darkness, and fog effects.
+ *
+ * The filter renders a dark overlay with circular light spots that illuminate areas.
+ * It supports multiple spots with individual intensity, radius, flicker, and pulse effects.
+ *
+ * @param viewport - Optional viewport for world-to-screen coordinate conversion
+ * @param options - Configuration options for the filter
+ * @returns A NightFilter instance with methods to control the effect
+ *
+ * @example
+ * ```ts
+ * const filter = createNightFilter(viewport, {
+ *   spots: [{ x: 100, y: 100, radius: 200, intensity: 1.0 }],
+ *   darkness: 0.8,
+ *   darkColor: "#0a1020",
+ *   fogColor: "#141a2a",
+ * });
+ * container.filters = [filter];
+ * ```
+ */
+export declare function createNightFilter(viewport?: ViewportLike, options?: {
+    lightWorldPosition?: PointLike | null;
+    spots?: NightSpot[];
+    getBounds?: () => BoundsLike | null | undefined;
+    darkness?: number;
+    darkColor?: ColorInput;
+    fogColor?: ColorInput;
+    fogRadius?: number;
+    fogSoftness?: number;
+}): NightFilter;
+/**
+ * Night ambiance component that adds a dark overlay with dynamic light spots.
+ *
+ * This component creates a night-time atmosphere with configurable darkness,
+ * fog effects, and multiple light sources. It automatically attaches to a
+ * Viewport if present in context, otherwise to the parent container.
+ *
+ * All props are reactive and support signal/function values.
+ *
+ * @param options - Configuration options for the night ambiance effect
+ *
+ * @example
+ * ```html
+ * <Viewport worldWidth={2048} worldHeight={2048} screen>
+ *   <NightAmbiant
+ *     lightSpots={lightSpots}
+ *     darkness={0.8}
+ *     darkColor="#0a1020"
+ *     fogColor="#141a2a"
+ *   />
+ * </Viewport>
+ * ```
+ */
+export declare function NightAmbiant(options?: NightAmbiantProps): import('../packages/core/src/index.ts').Element<import('../packages/core/src/index.ts').ComponentInstance> | Promise<import('../packages/core/src/index.ts').Element<import('../packages/core/src/index.ts').ComponentInstance>>;
+export {};
 //# sourceMappingURL=NightAmbiant.d.ts.map

package/dist/NightAmbiant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NightAmbiant.d.ts","sourceRoot":"","sources":["../src/NightAmbiant.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,KAAA,4EA8C7B;AAED,wBAAgB,YAAY,CAAC,KAAK,KAAA,gKA6DjC"}
+{"version":3,"file":"NightAmbiant.d.ts","sourceRoot":"","sources":["../src/NightAmbiant.ts"],"names":[],"mappings":"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"}

package/dist/Weathers/fog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fog.d.ts","sourceRoot":"","sources":["../../src/Weathers/fog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,wBAAgB,eAAe,IAAI,SAAS,CAkF3C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAoF7C"}
+{"version":3,"file":"fog.d.ts","sourceRoot":"","sources":["../../src/Weathers/fog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,wBAAgB,eAAe,IAAI,SAAS,CAwF3C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CA2F7C"}

package/dist/Weathers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Weathers/index.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAO,iKA+NpC,CAAC;AAEF,eAAO,MAAM,OAAO,gLAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Weathers/index.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAO,iKA4QpC,CAAC;AAEF,eAAO,MAAM,OAAO,gLAAgB,CAAC"}

package/dist/Weathers/rain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rain.d.ts","sourceRoot":"","sources":["../../src/Weathers/rain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,wBAAgB,gBAAgB,IAAI,SAAS,CA6F5C"}
+{"version":3,"file":"rain.d.ts","sourceRoot":"","sources":["../../src/Weathers/rain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,wBAAgB,gBAAgB,IAAI,SAAS,CAgG5C"}

package/dist/Weathers/snow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snow.d.ts","sourceRoot":"","sources":["../../src/Weathers/snow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAqG5C"}
+{"version":3,"file":"snow.d.ts","sourceRoot":"","sources":["../../src/Weathers/snow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAwG5C"}