@flighthq/types 0.4.0-next.1416.ef4fae7 → 0.4.0-next.1487.e25e95d

package/dist/BevelEffect.d.ts

@@ -2,10 +2,26 @@ import type { EffectSourceMode } from './EffectSourceMode';
 import type { RenderEffect } from './RenderEffect';
 export interface BevelEffect extends RenderEffect {
     kind: 'BevelEffect';
+    /**
+     * Direction of the light that casts the bevel, in DEGREES (default 45).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam. 0 offsets to
+     * the RIGHT and 90 offsets DOWNWARD, the way an author reads the picture.
+     *
+     * ★ THE UNIT IS STATED ON EVERY ANGLE FIELD IN THE SDK, and this family is why. `DirectionalBlurEffect`
+     * and `HalftoneEffect` carried radians here while these four carried degrees, with nothing in either
+     * header saying so; they are all degrees now. Naming only "radians" or only "degrees" without the
+     * origin and sense is what let the whole class of defect through in the first place.
+     */
     angle?: number;
     bevelType?: 'full' | 'inner' | 'outer';
     blurX?: number;
     blurY?: number;
+    /**
+     * Length of the bevel offset in PIXELS along `angle` (default 4). A magnitude, so it carries no origin of
+     * its own — the convention that decides where the offset LANDS lives on `angle`.
+     */
     distance?: number;
     highlightAlpha?: number;
     highlightColor?: number;

package/dist/BevelEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BevelEffect.d.ts","sourceRoot":"","sources":["../src/BevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IAIxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"BevelEffect.d.ts","sourceRoot":"","sources":["../src/BevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,EAAE,aAAa,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IAIxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/ContactShadowsEffect.d.ts

@@ -1,6 +1,11 @@
 import type { RenderEffect } from './RenderEffect';
 export interface ContactShadowsEffect extends RenderEffect {
     kind: 'ContactShadowsEffect';
+    /**
+     * Occlusion search radius, as the normalized radius forwarded to the SSAO pass (default 0.5). A
+     * magnitude with no direction and no origin — it is NOT an offset like `DropShadowEffect.distance`,
+     * which is a pixel length along an angle. Named here so the two are not read as the same parameter.
+     */
     distance?: number;
     opacity?: number;
     samples?: number;

package/dist/ContactShadowsEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactShadowsEffect.d.ts","sourceRoot":"","sources":["../src/ContactShadowsEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"ContactShadowsEffect.d.ts","sourceRoot":"","sources":["../src/ContactShadowsEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,sBAAsB,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/DirectionalBlurEffect.d.ts

@@ -1,6 +1,18 @@
 import type { RenderEffect } from './RenderEffect';
 export interface DirectionalBlurEffect extends RenderEffect {
     kind: 'DirectionalBlurEffect';
+    /**
+     * Direction the frame is smeared along, in DEGREES (default 0).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam. 0 smears
+     * HORIZONTALLY and 90 smears VERTICALLY DOWNWARD.
+     *
+     * ★ THIS FIELD WAS RADIANS UNTIL THE UNIT WAS UNIFIED, and it is where "a unit is not a convention"
+     * became visible: the header said "radians" and nothing else, which reads as documented and is not. A blur axis is symmetric
+     * under a half turn, so only an off-axis angle can show a Y-origin error here — which is why the
+     * scene uses a diagonal one.
+     */
     angle?: number;
     length?: number;
     samples?: number;

package/dist/DirectionalBlurEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectionalBlurEffect.d.ts","sourceRoot":"","sources":["../src/DirectionalBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"DirectionalBlurEffect.d.ts","sourceRoot":"","sources":["../src/DirectionalBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/DropShadowEffect.d.ts

@@ -3,10 +3,26 @@ import type { RenderEffect } from './RenderEffect';
 export interface DropShadowEffect extends RenderEffect {
     kind: 'DropShadowEffect';
     alpha?: number;
+    /**
+     * Direction of the shadow offset, in DEGREES (default 45).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam. 0 offsets to
+     * the RIGHT and 90 offsets DOWNWARD, the way an author reads the picture.
+     *
+     * ★ THE UNIT IS STATED ON EVERY ANGLE FIELD IN THE SDK, and this family is why. `DirectionalBlurEffect`
+     * and `HalftoneEffect` carried radians here while these four carried degrees, with nothing in either
+     * header saying so; they are all degrees now. Naming only "radians" or only "degrees" without the
+     * origin and sense is what let the whole class of defect through in the first place.
+     */
     angle?: number;
     blurX?: number;
     blurY?: number;
     color?: number;
+    /**
+     * Length of the shadow offset in PIXELS along `angle` (default 4). A magnitude, so it carries no origin of
+     * its own — the convention that decides where the offset LANDS lives on `angle`.
+     */
     distance?: number;
     quality?: number;
     sourceMode?: EffectSourceMode;

package/dist/DropShadowEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DropShadowEffect.d.ts","sourceRoot":"","sources":["../src/DropShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"DropShadowEffect.d.ts","sourceRoot":"","sources":["../src/DropShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/GodRaysEffect.d.ts

@@ -1,7 +1,26 @@
 import type { RenderEffect } from './RenderEffect';
 export interface GodRaysEffect extends RenderEffect {
     kind: 'GodRaysEffect';
+    /**
+     * The light's horizontal position as a fraction of the frame, 0 at the LEFT edge and 1 at the right.
+     *
+     * ★ THE ORIGIN IS PART OF THE CONTRACT, NOT THE BACKEND'S BUSINESS. See `centerY`.
+     */
     centerX?: number;
+    /**
+     * The light's vertical position as a fraction of the frame, **0 at the TOP edge and 1 at the bottom** —
+     * the same top-left origin the authoring layer uses everywhere else, so `centerY: 0.4` names the row a
+     * reader would call 40% down the picture.
+     *
+     * ★ THIS ORIGIN IS DECLARED BECAUSE ITS ABSENCE WAS A SHIPPED BUG. The two backends' effect passes use
+     * opposite texture-space conventions — Gl's fullscreen quad carries bottom-left-origin texcoords, Wgpu's
+     * carries top-left — and both runners forwarded this value untouched. The same `centerY: 0.4` therefore
+     * placed the light 240 px down on Wgpu and 360 px down on Gl: the rays radiated from different points,
+     * the shader text was identical on both sides, and nothing in the type said which one was right.
+     *
+     * A runner must NORMALISE this value into its own texture space at its own seam, exactly as the SDK
+     * converts degrees to radians at the authoring/math boundary rather than letting each caller guess.
+     */
     centerY?: number;
     density?: number;
     decay?: number;

package/dist/GodRaysEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GodRaysEffect.d.ts","sourceRoot":"","sources":["../src/GodRaysEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"GodRaysEffect.d.ts","sourceRoot":"","sources":["../src/GodRaysEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/GradientBevelEffect.d.ts

@@ -3,11 +3,27 @@ import type { RenderEffect } from './RenderEffect';
 export interface GradientBevelEffect extends RenderEffect {
     kind: 'GradientBevelEffect';
     alphas: ReadonlyArray<number>;
+    /**
+     * Direction of the light that casts the bevel, in DEGREES (default 45).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam. 0 offsets to
+     * the RIGHT and 90 offsets DOWNWARD, the way an author reads the picture.
+     *
+     * ★ THE UNIT IS STATED ON EVERY ANGLE FIELD IN THE SDK, and this family is why. `DirectionalBlurEffect`
+     * and `HalftoneEffect` carried radians here while these four carried degrees, with nothing in either
+     * header saying so; they are all degrees now. Naming only "radians" or only "degrees" without the
+     * origin and sense is what let the whole class of defect through in the first place.
+     */
     angle?: number;
     bevelType?: 'full' | 'inner' | 'outer';
     blurX?: number;
     blurY?: number;
     colors: ReadonlyArray<number>;
+    /**
+     * Length of the bevel offset in PIXELS along `angle` (default 4). A magnitude, so it carries no origin of
+     * its own — the convention that decides where the offset LANDS lives on `angle`.
+     */
     distance?: number;
     quality?: number;
     ratios: ReadonlyArray<number>;

package/dist/GradientBevelEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GradientBevelEffect.d.ts","sourceRoot":"","sources":["../src/GradientBevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"GradientBevelEffect.d.ts","sourceRoot":"","sources":["../src/GradientBevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/HalftoneEffect.d.ts

@@ -2,6 +2,15 @@ import type { RenderEffect } from './RenderEffect';
 export interface HalftoneEffect extends RenderEffect {
     kind: 'HalftoneEffect';
     scale?: number;
+    /**
+     * Rotation of the halftone dot grid, in DEGREES (default 45).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam.
+     *
+     * Only an angle that is not a multiple of a quarter turn can reveal a Y-origin error, because the
+     * grid is symmetric under those; the default 45 is deliberately not one.
+     */
     angle?: number;
 }
 //# sourceMappingURL=HalftoneEffect.d.ts.map

package/dist/HalftoneEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HalftoneEffect.d.ts","sourceRoot":"","sources":["../src/HalftoneEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"HalftoneEffect.d.ts","sourceRoot":"","sources":["../src/HalftoneEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/InnerShadowEffect.d.ts

@@ -3,10 +3,26 @@ import type { RenderEffect } from './RenderEffect';
 export interface InnerShadowEffect extends RenderEffect {
     kind: 'InnerShadowEffect';
     alpha?: number;
+    /**
+     * Direction of the inner shadow offset, in DEGREES (default 45).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam. 0 offsets to
+     * the RIGHT and 90 offsets DOWNWARD, the way an author reads the picture.
+     *
+     * ★ THE UNIT IS STATED ON EVERY ANGLE FIELD IN THE SDK, and this family is why. `DirectionalBlurEffect`
+     * and `HalftoneEffect` carried radians here while these four carried degrees, with nothing in either
+     * header saying so; they are all degrees now. Naming only "radians" or only "degrees" without the
+     * origin and sense is what let the whole class of defect through in the first place.
+     */
     angle?: number;
     blurX?: number;
     blurY?: number;
     color?: number;
+    /**
+     * Length of the inner shadow offset in PIXELS along `angle` (default 4). A magnitude, so it carries no origin of
+     * its own — the convention that decides where the offset LANDS lives on `angle`.
+     */
     distance?: number;
     quality?: number;
     sourceMode?: InnerEffectSourceMode;

package/dist/InnerShadowEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InnerShadowEffect.d.ts","sourceRoot":"","sources":["../src/InnerShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"InnerShadowEffect.d.ts","sourceRoot":"","sources":["../src/InnerShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/RadialBlurEffect.d.ts

@@ -1,7 +1,22 @@
 import type { RenderEffect } from './RenderEffect';
 export interface RadialBlurEffect extends RenderEffect {
     kind: 'RadialBlurEffect';
+    /**
+     * Horizontal centre of the radial smear as a fraction of the frame, 0 at the LEFT edge and 1 at the
+     * right (default 0.5). X has the same origin on every backend, so no runner converts it.
+     */
     centerX?: number;
+    /**
+     * Vertical centre of the radial smear as a fraction of the frame, 0 at the TOP edge and 1 at the
+     * bottom (default 0.5).
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam.
+     *
+     * ★ THE Gl RUNNER FLIPS THIS AND THE Wgpu RUNNER DOES NOT, and both are correct: Gl's fullscreen
+     * quad is bottom-left origin and Wgpu's is top-left. A centred blur is its own mirror, so 0.5 cannot
+     * show a missing conversion — the scene uses an off-centre value for exactly that reason.
+     */
     centerY?: number;
     strength?: number;
     samples?: number;

package/dist/RadialBlurEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RadialBlurEffect.d.ts","sourceRoot":"","sources":["../src/RadialBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"RadialBlurEffect.d.ts","sourceRoot":"","sources":["../src/RadialBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,kBAAkB,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/TiltShiftEffect.d.ts

@@ -1,6 +1,16 @@
 import type { RenderEffect } from './RenderEffect';
 export interface TiltShiftEffect extends RenderEffect {
     kind: 'TiltShiftEffect';
+    /**
+     * Centre of the focus band on Y, 0 at the TOP edge and 1 at the bottom — the same orientation an
+     * author reads the picture in, and the same convention GodRaysEffect.centerY uses.
+     *
+     * This is a value in the DESCRIPTOR's space, not in any backend's texture space. A runner must
+     * normalise it into its own at its own seam, exactly as the SDK converts degrees to radians: the Gl
+     * runner flips it because its fullscreen quad is bottom-left-origin, while the Wgpu and Canvas
+     * runners pass it straight through. A centred band cannot reveal a runner that skips the
+     * conversion, because the distance is symmetric about 0.5.
+     */
     center?: number;
     width?: number;
     blur?: number;

package/dist/TiltShiftEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TiltShiftEffect.d.ts","sourceRoot":"","sources":["../src/TiltShiftEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"TiltShiftEffect.d.ts","sourceRoot":"","sources":["../src/TiltShiftEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/VolumetricLightEffect.d.ts

@@ -3,7 +3,23 @@ export interface VolumetricLightEffect extends RenderEffect {
     kind: 'VolumetricLightEffect';
     density?: number;
     lightColor?: number;
+    /**
+     * Horizontal light position as a fraction of the frame, 0 at the LEFT edge and 1 at the right.
+     *
+     * ★ NOT YET REALIZED: no backend runner reads this field, so the convention above is the intended
+     * one rather than an observed one, and it is settled the day a runner is written.
+     */
     lightX?: number;
+    /**
+     * Vertical light position as a fraction of the frame, 0 at the TOP edge and 1 at the bottom.
+     *
+     * Screen space: origin top-left, +Y down, angles measured from +X toward +Y — clockwise as
+     * displayed. Each runner converts into its own texcoord space at its own seam.
+     *
+     * ★ NOT YET REALIZED: no backend runner reads this field, so a future runner on a bottom-left-origin
+     * target must convert at its own seam, exactly as `RadialBlurEffect.centerY` and
+     * `GodRaysEffect.centerY` do.
+     */
     lightY?: number;
     samples?: number;
     scattering?: number;

package/dist/VolumetricLightEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VolumetricLightEffect.d.ts","sourceRoot":"","sources":["../src/VolumetricLightEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"VolumetricLightEffect.d.ts","sourceRoot":"","sources":["../src/VolumetricLightEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/types",
-  "version": "0.4.0-next.1416.ef4fae7",
+  "version": "0.4.0-next.1487.e25e95d",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {