@canvasengine/presets 2.0.0-beta.53 → 2.0.0-beta.54

package/dist/Footprints.d.ts

@@ -0,0 +1,50 @@
+type ReactiveValue<T> = T | (() => T);
+type PointLike = {
+    x: number;
+    y: number;
+};
+type ColorInput = string | number;
+export type FootprintSurfaceProfile = {
+    lifetimeMs?: ReactiveValue<number>;
+    startAlpha?: ReactiveValue<number>;
+    endAlpha?: ReactiveValue<number>;
+    tint?: ReactiveValue<ColorInput>;
+    blendMode?: ReactiveValue<any>;
+    scale?: ReactiveValue<number>;
+    blurStart?: ReactiveValue<number>;
+    blurEnd?: ReactiveValue<number>;
+    erosionStart?: ReactiveValue<number>;
+    depth?: ReactiveValue<number>;
+    rimStrength?: ReactiveValue<number>;
+};
+export type FootprintCasterOptions = {
+    enabled?: ReactiveValue<boolean>;
+    footAnchor?: ReactiveValue<PointLike>;
+    leftOffset?: ReactiveValue<PointLike>;
+    rightOffset?: ReactiveValue<PointLike>;
+    minStepDistance?: ReactiveValue<number>;
+    minSpeed?: ReactiveValue<number>;
+    stepIntervalMs?: ReactiveValue<number>;
+    size?: ReactiveValue<number>;
+    alpha?: ReactiveValue<number>;
+    blur?: ReactiveValue<number>;
+    surface?: ReactiveValue<string>;
+    angleOffset?: ReactiveValue<number>;
+    jitter?: ReactiveValue<number>;
+};
+export type FootprintsProps = {
+    profiles?: ReactiveValue<Record<string, FootprintSurfaceProfile>>;
+    defaultSurface?: ReactiveValue<string>;
+    maxFootprints?: ReactiveValue<number>;
+    updateHz?: ReactiveValue<number>;
+};
+/**
+ * Footprints preset
+ *
+ * Adds fading footprints behind moving sprites tagged with `footprintCaster`.
+ * Footprints are generated procedurally (no image required) and can be tuned
+ * per surface profile (for example `sand` and `snow`).
+ */
+export declare function Footprints(options?: FootprintsProps): 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=Footprints.d.ts.map

package/dist/Footprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footprints.d.ts","sourceRoot":"","sources":["../src/Footprints.ts"],"names":[],"mappings":"AASA,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1C,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AA6DlC,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClE,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAmZF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,eAAoB,gKAwZvD"}

package/dist/SpriteShadows.d.ts

@@ -0,0 +1,60 @@
+type ReactiveValue<T> = T | (() => T);
+type PointLike = {
+    x: number;
+    y: number;
+};
+type ColorInput = string | number;
+export type ShadowLight = {
+    x: number;
+    y: number;
+    z?: number;
+    radius?: number;
+    intensity?: number;
+    shadowWeight?: number;
+    enabled?: boolean;
+};
+export type ShadowLightInput = {
+    x: ReactiveValue<number>;
+    y: ReactiveValue<number>;
+    z?: ReactiveValue<number>;
+    radius?: ReactiveValue<number>;
+    intensity?: ReactiveValue<number>;
+    shadowWeight?: ReactiveValue<number>;
+    enabled?: ReactiveValue<boolean>;
+};
+export type ShadowCasterOptions = {
+    enabled?: ReactiveValue<boolean>;
+    height?: ReactiveValue<number>;
+    footOffset?: ReactiveValue<PointLike>;
+    footAnchor?: ReactiveValue<PointLike>;
+    alpha?: ReactiveValue<number>;
+    blur?: ReactiveValue<number>;
+    gradientPower?: ReactiveValue<number>;
+    hardness?: ReactiveValue<number>;
+    minLength?: ReactiveValue<number>;
+    maxLength?: ReactiveValue<number>;
+    contactAlpha?: ReactiveValue<number>;
+    contactScale?: ReactiveValue<number>;
+    anchorX?: ReactiveValue<number>;
+};
+type ShadowMode = "strongest" | "blend2";
+export type SpriteShadowsProps = {
+    lights?: ReactiveValue<Array<ShadowLightInput | ShadowLight>>;
+    sources?: ReactiveValue<Array<ShadowLightInput | ShadowLight>>;
+    mode?: ReactiveValue<ShadowMode>;
+    updateHz?: ReactiveValue<number>;
+    shadowColor?: ReactiveValue<ColorInput>;
+};
+/**
+ * SpriteShadows preset
+ *
+ * Adds RPG-style projected shadows for sprites tagged with `shadowCaster`.
+ * The shadow direction is automatically opposite to the dominant light source.
+ *
+ * Usage:
+ * - Add `<SpriteShadows lights={lights} />` in your scene (preferably inside `Viewport`).
+ * - Add `shadowCaster` on any sprite that should cast a shadow.
+ */
+export declare function SpriteShadows(options?: SpriteShadowsProps): 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=SpriteShadows.d.ts.map

package/dist/SpriteShadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteShadows.d.ts","sourceRoot":"","sources":["../src/SpriteShadows.ts"],"names":[],"mappings":"AAUA,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1C,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACzC,CAAC;AAunBF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,kBAAuB,gKAyF7D"}

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export * from './Loading';
 export * from './Tilemap';
 export * from './Weathers';
 export * from './FogOfWar';
+export * from './SpriteShadows';
+export * from './Footprints';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}