@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/features/viz/lib/weighted-point-series.d.ts

@@ -0,0 +1,71 @@
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId, SeriesAccessor } from "./types.js";
+/**
+ * A data property or callback extracting a nonnegative research weight.
+ *
+ * @see {@link WeightedPointSeriesProps}
+ */
+export type WeightAccessor<D> = LineAccessor<D>;
+/** Shared presentation for {@link WeightedPointSeries}. */
+export interface WeightedPointSeriesStyle {
+    /** Paint used for point interiors. Defaults to `#087f8c`. */
+    readonly fill?: FillStyle;
+    /** Paint used for point outlines. Defaults to no outline. */
+    readonly stroke?: StrokeStyle;
+    /** Outline width in local coordinate units. Defaults to 1. */
+    readonly strokeWidth?: number;
+    /** Opacity in the inclusive range [0, 1]. Defaults to 1. */
+    readonly opacity?: number;
+    /** Pointer cursor while the series owns a target. */
+    readonly cursor?: string;
+}
+/**
+ * Authored inputs for {@link WeightedPointSeries}.
+ *
+ * Weights are supplied data, not calculated precision, sample size, or evidence.
+ * The zero baseline and squared-radius interpolation make displayed area linear in
+ * the supplied weight.
+ */
+export interface WeightedPointSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Readonly data or a signal containing it. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Horizontal coordinate property or synchronous accessor. */
+    readonly x: SeriesAccessor<D>;
+    /** Vertical coordinate property or synchronous accessor. */
+    readonly y: SeriesAccessor<D>;
+    /** Nonnegative supplied weight property or synchronous accessor. */
+    readonly weight: WeightAccessor<D>;
+    /** Scale used to map x coordinates. */
+    readonly xScale: ScaleId;
+    /** Scale used to map y coordinates. */
+    readonly yScale: ScaleId;
+    /** Supplied inclusive weight extent. The lower bound must be zero. */
+    readonly weightDomain: readonly [0, number];
+    /** Radius extent `[0, maximumRadius]`; defaults to `[0, 6]`. */
+    readonly radiusRange?: readonly [0, number];
+    /**
+     * Excludes a datum before coordinate and weight accessors run.
+     * @param datum - Candidate source datum.
+     * @param index - Zero-based source index.
+     * @param data - Complete source data array.
+     * @returns Whether this datum contributes a mark.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared presentation. Whole-object and shallow field signals are supported. */
+    readonly style?: SignalValue<SignalStyle<WeightedPointSeriesStyle>>;
+}
+/**
+ * Draws batched circles whose visible area is proportional to supplied weights.
+ *
+ * Nullish weights and zero weights omit their marks. Finite positive weights must
+ * fall inside `weightDomain`; the component never clamps or infers weights.
+ * `data` and shared style signals schedule ordinary Pibbl updates. The component
+ * owns no retained resources and returns one ordinary Pibbl pointer target.
+ *
+ * @param props - Supplied observations, coordinate and weight accessors, scales, and paint.
+ * See {@link WeightedPointSeriesProps}.
+ * @returns One batched Pibbl Path whose mark area is proportional to each supplied weight.
+ * @see {@link WeightedPointSeriesProps}
+ */
+export declare function WeightedPointSeries<D>({ data: input, x: xInput, y: yInput, weight: weightInput, xScale: xId, yScale: yId, weightDomain, radiusRange, defined, style: styleInput, ...events }: WeightedPointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

package/dist/features/viz/lib/weighted-point-series.js

@@ -0,0 +1,169 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { resolveTexturePaint } from "@pibbl/core/internal";
+import { Path, resolveSignalValue, useCanvasContext } from "@pibbl/core";
+import { validateTexturePaint, withHooksForbidden } from "@pibbl/core/internal";
+import { pointAccessor, pointData } from "./point-data.js";
+import { appendPointTarget, pointPath } from "./point-geometry.js";
+import { opacity, width } from "./paint.js";
+import {
+  mapSeriesPosition,
+  seriesAccessor,
+  useSeriesPosition
+} from "./series-position.js";
+const fields = ["fill", "stroke", "strokeWidth", "opacity", "cursor"];
+function paint(value, name) {
+  if (value === void 0 || typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+  }
+  throw new TypeError(`WeightedPointSeries: invalid ${name}.`);
+}
+function styleObject(input) {
+  if (input === null || typeof input !== "object" || Array.isArray(input))
+    throw new TypeError("WeightedPointSeries: style must be an object.");
+  const result = {};
+  for (const key of Object.keys(input)) {
+    if (!fields.includes(key))
+      throw new TypeError(
+        `WeightedPointSeries: unsupported style field ${key}.`
+      );
+    result[key] = resolveSignalValue(input[key]);
+  }
+  return result;
+}
+function normalized(style) {
+  if (style.cursor !== void 0 && typeof style.cursor !== "string")
+    throw new TypeError("WeightedPointSeries: cursor must be a string.");
+  return {
+    fill: paint(style.fill ?? "#087f8c", "fill"),
+    stroke: paint(style.stroke, "stroke"),
+    strokeWidth: width(
+      style.strokeWidth ?? 1,
+      "WeightedPointSeries strokeWidth"
+    ),
+    opacity: opacity(style.opacity ?? 1, "WeightedPointSeries opacity"),
+    cursor: style.cursor
+  };
+}
+function range(value) {
+  const actual = value ?? [0, 6];
+  if (!Array.isArray(actual) || actual.length !== 2 || actual[0] !== 0 || !Number.isFinite(actual[1]) || actual[1] < 0)
+    throw new RangeError(
+      "WeightedPointSeries: radiusRange must be [0, a finite nonnegative maximum]."
+    );
+  return actual;
+}
+function domain(value) {
+  if (!Array.isArray(value) || value.length !== 2 || value[0] !== 0 || !Number.isFinite(value[1]) || value[1] <= 0)
+    throw new RangeError(
+      "WeightedPointSeries: weightDomain must be [0, a finite positive maximum]."
+    );
+  return value;
+}
+function WeightedPointSeries({
+  data: input,
+  x: xInput,
+  y: yInput,
+  weight: weightInput,
+  xScale: xId,
+  yScale: yId,
+  weightDomain,
+  radiusRange,
+  defined,
+  style: styleInput,
+  ...events
+}) {
+  const xs = useSeriesPosition(xId);
+  const ys = useSeriesPosition(yId);
+  const data = pointData(resolveSignalValue(input), "WeightedPointSeries");
+  const x = seriesAccessor(xInput);
+  const y = seriesAccessor(yInput);
+  const weight = pointAccessor(weightInput);
+  const [, maximumWeight] = domain(weightDomain);
+  const [, maximumRadius] = range(radiusRange);
+  const style = normalized(styleObject(resolveSignalValue(styleInput) ?? {}));
+  const ctx = useCanvasContext();
+  const target = new Path2D();
+  const marks = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const values = withHooksForbidden(
+      "WeightedPointSeries: accessors cannot call hooks.",
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          x: x(datum, i, data),
+          y: y(datum, i, data),
+          weight: weight(datum, i, data)
+        };
+      }
+    );
+    if (!values) continue;
+    const mappedX = mapSeriesPosition(xs, values.x);
+    const mappedY = mapSeriesPosition(ys, values.y);
+    if (mappedX === void 0 || mappedY === void 0) continue;
+    const supplied = values.weight;
+    if (supplied == null) continue;
+    if (typeof supplied !== "number" || !Number.isFinite(supplied))
+      throw new TypeError(
+        "WeightedPointSeries: weight must be a finite number."
+      );
+    if (supplied < 0)
+      throw new RangeError("WeightedPointSeries: weight must be nonnegative.");
+    if (supplied > maximumWeight)
+      throw new RangeError("WeightedPointSeries: weight exceeds weightDomain.");
+    if (supplied === 0 || maximumRadius === 0) continue;
+    const radius = maximumRadius * Math.sqrt(supplied / maximumWeight);
+    marks.push({ x: mappedX, y: mappedY, radius });
+  }
+  for (const { x: x2, y: y2, radius } of marks) {
+    appendPointTarget(
+      target,
+      x2,
+      y2,
+      radius,
+      !!style.fill,
+      style.stroke ? style.strokeWidth : 0
+    );
+    const path = pointPath(x2, y2, radius);
+    ctx.save();
+    try {
+      ctx.globalAlpha *= style.opacity;
+      if (style.fill) {
+        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, {
+          x: x2 - radius,
+          y: y2 - radius,
+          width: radius * 2,
+          height: radius * 2
+        });
+        ctx.fill(path);
+      }
+      if (style.stroke && style.strokeWidth > 0) {
+        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, {
+          x: x2 - radius,
+          y: y2 - radius,
+          width: radius * 2,
+          height: radius * 2
+        });
+        ctx.lineWidth = style.strokeWidth;
+        ctx.stroke(path);
+      }
+    } finally {
+      ctx.restore();
+    }
+  }
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...events,
+      style: { d: target, fill: "transparent", cursor: style.cursor }
+    }
+  );
+}
+export {
+  WeightedPointSeries
+};
+//# sourceMappingURL=weighted-point-series.js.map

package/dist/features/viz/lib/weighted-point-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/weighted-point-series.tsx"],
+  "sourcesContent": ["import { resolveTexturePaint } from \"@pibbl/core/internal\";\nimport { Path, resolveSignalValue, useCanvasContext } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport { validateTexturePaint, withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { LineAccessor, ScaleId, SeriesAccessor } from \"./types.js\";\nimport { pointAccessor, pointData } from \"./point-data.js\";\nimport { appendPointTarget, pointPath } from \"./point-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\nimport {\n  mapSeriesPosition,\n  seriesAccessor,\n  useSeriesPosition,\n} from \"./series-position.js\";\n\nconst fields = [\"fill\", \"stroke\", \"strokeWidth\", \"opacity\", \"cursor\"];\n\n/**\n * A data property or callback extracting a nonnegative research weight.\n *\n * @see {@link WeightedPointSeriesProps}\n */\nexport type WeightAccessor<D> = LineAccessor<D>;\n\n/** Shared presentation for {@link WeightedPointSeries}. */\nexport interface WeightedPointSeriesStyle {\n  /** Paint used for point interiors. Defaults to `#087f8c`. */\n  readonly fill?: FillStyle;\n  /** Paint used for point outlines. Defaults to no outline. */\n  readonly stroke?: StrokeStyle;\n  /** Outline width in local coordinate units. Defaults to 1. */\n  readonly strokeWidth?: number;\n  /** Opacity in the inclusive range [0, 1]. Defaults to 1. */\n  readonly opacity?: number;\n  /** Pointer cursor while the series owns a target. */\n  readonly cursor?: string;\n}\n\n/**\n * Authored inputs for {@link WeightedPointSeries}.\n *\n * Weights are supplied data, not calculated precision, sample size, or evidence.\n * The zero baseline and squared-radius interpolation make displayed area linear in\n * the supplied weight.\n */\nexport interface WeightedPointSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Readonly data or a signal containing it. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Horizontal coordinate property or synchronous accessor. */\n  readonly x: SeriesAccessor<D>;\n  /** Vertical coordinate property or synchronous accessor. */\n  readonly y: SeriesAccessor<D>;\n  /** Nonnegative supplied weight property or synchronous accessor. */\n  readonly weight: WeightAccessor<D>;\n  /** Scale used to map x coordinates. */\n  readonly xScale: ScaleId;\n  /** Scale used to map y coordinates. */\n  readonly yScale: ScaleId;\n  /** Supplied inclusive weight extent. The lower bound must be zero. */\n  readonly weightDomain: readonly [0, number];\n  /** Radius extent `[0, maximumRadius]`; defaults to `[0, 6]`. */\n  readonly radiusRange?: readonly [0, number];\n  /**\n   * Excludes a datum before coordinate and weight accessors run.\n   * @param datum - Candidate source datum.\n   * @param index - Zero-based source index.\n   * @param data - Complete source data array.\n   * @returns Whether this datum contributes a mark.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared presentation. Whole-object and shallow field signals are supported. */\n  readonly style?: SignalValue<SignalStyle<WeightedPointSeriesStyle>>;\n}\n\nfunction paint(\n  value: unknown,\n  name: string,\n): FillStyle | StrokeStyle | undefined {\n  if (\n    value === undefined ||\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  try {\n    validateTexturePaint(value as never);\n    return value as FillStyle | StrokeStyle;\n  } catch {\n    // Normalize all unsupported public paint values to the series error.\n  }\n  throw new TypeError(`WeightedPointSeries: invalid ${name}.`);\n}\n\nfunction styleObject(input: unknown): WeightedPointSeriesStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"WeightedPointSeries: style must be an object.\");\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(input)) {\n    if (!fields.includes(key))\n      throw new TypeError(\n        `WeightedPointSeries: unsupported style field ${key}.`,\n      );\n    result[key] = resolveSignalValue((input as Record<string, unknown>)[key]);\n  }\n  return result as WeightedPointSeriesStyle;\n}\n\nfunction normalized(style: WeightedPointSeriesStyle) {\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(\"WeightedPointSeries: cursor must be a string.\");\n  return {\n    fill: paint(style.fill ?? \"#087f8c\", \"fill\"),\n    stroke: paint(style.stroke, \"stroke\"),\n    strokeWidth: width(\n      style.strokeWidth ?? 1,\n      \"WeightedPointSeries strokeWidth\",\n    ),\n    opacity: opacity(style.opacity ?? 1, \"WeightedPointSeries opacity\"),\n    cursor: style.cursor,\n  };\n}\n\nfunction range(\n  value: readonly [number, number] | undefined,\n): readonly [number, number] {\n  const actual: readonly [number, number] = value ?? [0, 6];\n  if (\n    !Array.isArray(actual) ||\n    actual.length !== 2 ||\n    actual[0] !== 0 ||\n    !Number.isFinite(actual[1]) ||\n    actual[1] < 0\n  )\n    throw new RangeError(\n      \"WeightedPointSeries: radiusRange must be [0, a finite nonnegative maximum].\",\n    );\n  return actual;\n}\n\nfunction domain(value: readonly [0, number]): readonly [number, number] {\n  if (\n    !Array.isArray(value) ||\n    value.length !== 2 ||\n    value[0] !== 0 ||\n    !Number.isFinite(value[1]) ||\n    value[1] <= 0\n  )\n    throw new RangeError(\n      \"WeightedPointSeries: weightDomain must be [0, a finite positive maximum].\",\n    );\n  return value;\n}\n\n/**\n * Draws batched circles whose visible area is proportional to supplied weights.\n *\n * Nullish weights and zero weights omit their marks. Finite positive weights must\n * fall inside `weightDomain`; the component never clamps or infers weights.\n * `data` and shared style signals schedule ordinary Pibbl updates. The component\n * owns no retained resources and returns one ordinary Pibbl pointer target.\n *\n * @param props - Supplied observations, coordinate and weight accessors, scales, and paint.\n * See {@link WeightedPointSeriesProps}.\n * @returns One batched Pibbl Path whose mark area is proportional to each supplied weight.\n * @see {@link WeightedPointSeriesProps}\n */\nexport function WeightedPointSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  weight: weightInput,\n  xScale: xId,\n  yScale: yId,\n  weightDomain,\n  radiusRange,\n  defined,\n  style: styleInput,\n  ...events\n}: WeightedPointSeriesProps<D>) {\n  const xs = useSeriesPosition(xId);\n  const ys = useSeriesPosition(yId);\n  const data = pointData(resolveSignalValue(input), \"WeightedPointSeries\");\n  const x = seriesAccessor(xInput);\n  const y = seriesAccessor(yInput);\n  const weight = pointAccessor(weightInput);\n  const [, maximumWeight] = domain(weightDomain);\n  const [, maximumRadius] = range(radiusRange);\n  const style = normalized(styleObject(resolveSignalValue(styleInput) ?? {}));\n  const ctx = useCanvasContext();\n  const target = new Path2D();\n  const marks: {\n    readonly x: number;\n    readonly y: number;\n    readonly radius: number;\n  }[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const values = withHooksForbidden(\n      \"WeightedPointSeries: accessors cannot call hooks.\",\n      () => {\n        if (defined && !defined(datum, i, data)) return undefined;\n        return {\n          x: x(datum, i, data),\n          y: y(datum, i, data),\n          weight: weight(datum, i, data),\n        };\n      },\n    );\n    if (!values) continue;\n    const mappedX = mapSeriesPosition(xs, values.x);\n    const mappedY = mapSeriesPosition(ys, values.y);\n    if (mappedX === undefined || mappedY === undefined) continue;\n    const supplied = values.weight;\n    if (supplied == null) continue;\n    if (typeof supplied !== \"number\" || !Number.isFinite(supplied))\n      throw new TypeError(\n        \"WeightedPointSeries: weight must be a finite number.\",\n      );\n    if (supplied < 0)\n      throw new RangeError(\"WeightedPointSeries: weight must be nonnegative.\");\n    if (supplied > maximumWeight)\n      throw new RangeError(\"WeightedPointSeries: weight exceeds weightDomain.\");\n    if (supplied === 0 || maximumRadius === 0) continue;\n    const radius = maximumRadius * Math.sqrt(supplied / maximumWeight);\n    marks.push({ x: mappedX, y: mappedY, radius });\n  }\n  for (const { x, y, radius } of marks) {\n    appendPointTarget(\n      target,\n      x,\n      y,\n      radius,\n      !!style.fill,\n      style.stroke ? style.strokeWidth : 0,\n    );\n    const path = pointPath(x, y, radius);\n    ctx.save();\n    try {\n      ctx.globalAlpha *= style.opacity;\n      if (style.fill) {\n        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, {\n          x: x - radius,\n          y: y - radius,\n          width: radius * 2,\n          height: radius * 2,\n        });\n        ctx.fill(path);\n      }\n      if (style.stroke && style.strokeWidth > 0) {\n        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, {\n          x: x - radius,\n          y: y - radius,\n          width: radius * 2,\n          height: radius * 2,\n        });\n        ctx.lineWidth = style.strokeWidth;\n        ctx.stroke(path);\n      }\n    } finally {\n      ctx.restore();\n    }\n  }\n  return (\n    <Path\n      {...events}\n      style={{ d: target, fill: \"transparent\", cursor: style.cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["x", "y"]
+}

package/dist/filters/backdrop-contrast-gpu.d.ts

@@ -0,0 +1,5 @@
+import { ReflectionGpu, type ReflectionGpuCallbacks } from "./reflection-gpu.js";
+/** Shares the existing private GPU resource/context-loss implementation. */
+export declare class BackdropContrastGpu extends ReflectionGpu {
+    constructor(callbacks?: Readonly<ReflectionGpuCallbacks>);
+}

package/dist/filters/backdrop-contrast-gpu.js

@@ -0,0 +1,33 @@
+import {
+  ReflectionGpu
+} from "./reflection-gpu.js";
+const fragment = `#version 300 es
+precision highp float;
+uniform sampler2D scene, map, lightMap;
+in vec2 uv;
+out vec4 outputColor;
+vec3 linearRgb(vec3 c) {
+  return mix(c/12.92,pow((c+.055)/1.055,vec3(2.4)),step(vec3(.04045),c));
+}
+void main() {
+  float coverage=texture(scene,uv).a;
+  vec4 backdrop=texture(map,uv);
+  // A transparent current target is evaluated over white; DOM pixels are unavailable.
+  vec3 background=mix(vec3(1),backdrop.rgb,backdrop.a);
+  float luminance=dot(linearRgb(background),vec3(.2126,.7152,.0722));
+  // Equal black/white contrast occurs at sqrt(.05*1.05)-.05.
+  int choice=luminance<.179128784747792?0:1;
+  vec4 color=texelFetch(lightMap,ivec2(choice,0),0);
+  float alpha=coverage*color.a;
+  outputColor=vec4(color.rgb*alpha,alpha);
+}
+`;
+class BackdropContrastGpu extends ReflectionGpu {
+  constructor(callbacks = {}) {
+    super(callbacks, fragment);
+  }
+}
+export {
+  BackdropContrastGpu
+};
+//# sourceMappingURL=backdrop-contrast-gpu.js.map

package/dist/filters/backdrop-contrast-gpu.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/backdrop-contrast-gpu.ts"],
+  "sourcesContent": ["import {\n  ReflectionGpu,\n  type ReflectionGpuCallbacks,\n} from \"./reflection-gpu.js\";\n\nconst fragment = `#version 300 es\nprecision highp float;\nuniform sampler2D scene, map, lightMap;\nin vec2 uv;\nout vec4 outputColor;\nvec3 linearRgb(vec3 c) {\n  return mix(c/12.92,pow((c+.055)/1.055,vec3(2.4)),step(vec3(.04045),c));\n}\nvoid main() {\n  float coverage=texture(scene,uv).a;\n  vec4 backdrop=texture(map,uv);\n  // A transparent current target is evaluated over white; DOM pixels are unavailable.\n  vec3 background=mix(vec3(1),backdrop.rgb,backdrop.a);\n  float luminance=dot(linearRgb(background),vec3(.2126,.7152,.0722));\n  // Equal black/white contrast occurs at sqrt(.05*1.05)-.05.\n  int choice=luminance<.179128784747792?0:1;\n  vec4 color=texelFetch(lightMap,ivec2(choice,0),0);\n  float alpha=coverage*color.a;\n  outputColor=vec4(color.rgb*alpha,alpha);\n}\n`;\n/** Shares the existing private GPU resource/context-loss implementation. */\nexport class BackdropContrastGpu extends ReflectionGpu {\n  constructor(callbacks: Readonly<ReflectionGpuCallbacks> = {}) {\n    super(callbacks, fragment);\n  }\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAEP,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBV,MAAM,4BAA4B,cAAc;AAAA,EACrD,YAAY,YAA8C,CAAC,GAAG;AAC5D,UAAM,WAAW,QAAQ;AAAA,EAC3B;AACF;",
+  "names": []
+}

package/dist/filters/backdrop-contrast.d.ts

@@ -0,0 +1,21 @@
+import type { SignalValue } from "../lib/signals/types.js";
+import { type PibblFilter } from "../lib/style/filter-types.js";
+/** Two foreground colors selected per backdrop pixel. See {@link backdropContrast}. */
+export interface PibblBackdropContrastFilterOptions {
+    /** Color drawn over dark backdrop pixels; defaults to white. See {@link SignalValue}. */
+    readonly light?: SignalValue<string>;
+    /** Color drawn over light backdrop pixels; defaults to black. See {@link SignalValue}. */
+    readonly dark?: SignalValue<string>;
+}
+/**
+ * Recolors a receiving primitive and its descendants per pixel, using their combined alpha
+ * as a mask. Chooses light below relative backdrop luminance 0.179129 and dark otherwise.
+ * Samples already-painted content in the current Canvas target; transparent backdrop is
+ * evaluated over white. Isolated/cached layers see their own local backdrop, not outer paint.
+ * Requires OffscreenCanvas and WebGL2; performs no scene pixel readback. Geometry is unchanged.
+ *
+ * @param options - Optional signal-capable foreground colors; white and black by default.
+ * See {@link PibblBackdropContrastFilterOptions}.
+ * @returns An immutable descriptor for style.filter. See {@link PibblFilter}.
+ */
+export declare function backdropContrast(options?: PibblBackdropContrastFilterOptions): PibblFilter;

package/dist/filters/backdrop-contrast.js

@@ -0,0 +1,61 @@
+import { isSignal } from "../lib/signals/graph.js";
+import { layoutDiagnostic } from "../lib/style/diagnostics.js";
+import {
+  PIBBL_FILTER_EXECUTOR
+} from "../lib/style/filter-types.js";
+import { concreteColor } from "./native-color.js";
+import {
+  filterBoundaryExecutor
+} from "./filter-executor.js";
+import { processBackdropContrast } from "./render-backdrop-contrast-boundary.js";
+const definitions = /* @__PURE__ */ new WeakMap();
+const executor = {
+  prepare(value, property, context) {
+    const options = definitions.get(value);
+    if (!options)
+      throw new Error(
+        "A backdropContrast filter was created by an incompatible Pibbl runtime."
+      );
+    const color = (key, fallback) => {
+      const input = options[key];
+      const value2 = input === void 0 ? fallback : isSignal(input) ? input.get() : input;
+      const result = concreteColor(value2, `${property}.${key}`, context);
+      if (typeof CSS === "undefined" || !CSS.supports("color", result))
+        throw layoutDiagnostic({
+          component: context.component,
+          property: `${property}.${key}`,
+          value: value2,
+          algorithm: context.algorithm,
+          constraints: context.constraints,
+          reason: "must be a supported concrete CSS color"
+        });
+      return result;
+    };
+    const light = color("light", "white"), dark = color("dark", "black");
+    return Object.freeze({
+      executor: filterBoundaryExecutor,
+      needsBackdrop: true,
+      reverseInfluence: (output) => ({ ...output }),
+      process: (source, windows, backdrop) => {
+        if (!backdrop)
+          throw new Error(
+            "backdropContrast requires the current Canvas backdrop."
+          );
+        return processBackdropContrast(source, windows, backdrop, {
+          light,
+          dark
+        });
+      }
+    });
+  },
+  render: filterBoundaryExecutor.render
+};
+function backdropContrast(options = {}) {
+  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });
+  definitions.set(value, Object.freeze({ ...options }));
+  return value;
+}
+export {
+  backdropContrast
+};
+//# sourceMappingURL=backdrop-contrast.js.map

package/dist/filters/backdrop-contrast.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/backdrop-contrast.ts"],
+  "sourcesContent": ["import { isSignal } from \"../lib/signals/graph.js\";\nimport type { SignalValue } from \"../lib/signals/types.js\";\nimport { layoutDiagnostic } from \"../lib/style/diagnostics.js\";\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblFilter,\n  type PibblFilterExecutor,\n} from \"../lib/style/filter-types.js\";\nimport { concreteColor } from \"./native-color.js\";\nimport {\n  filterBoundaryExecutor,\n  type CustomPreparedFilter,\n} from \"./filter-executor.js\";\nimport { processBackdropContrast } from \"./render-backdrop-contrast-boundary.js\";\n\n/** Two foreground colors selected per backdrop pixel. See {@link backdropContrast}. */\nexport interface PibblBackdropContrastFilterOptions {\n  /** Color drawn over dark backdrop pixels; defaults to white. See {@link SignalValue}. */\n  readonly light?: SignalValue<string>;\n  /** Color drawn over light backdrop pixels; defaults to black. See {@link SignalValue}. */\n  readonly dark?: SignalValue<string>;\n}\nconst definitions = new WeakMap<\n  PibblFilter,\n  Readonly<PibblBackdropContrastFilterOptions>\n>();\nconst executor: PibblFilterExecutor = {\n  prepare(value, property, context) {\n    const options = definitions.get(value);\n    if (!options)\n      throw new Error(\n        \"A backdropContrast filter was created by an incompatible Pibbl runtime.\",\n      );\n    const color = (key: \"light\" | \"dark\", fallback: string) => {\n      const input = options[key];\n      const value =\n        input === undefined ? fallback : isSignal(input) ? input.get() : input;\n      const result = concreteColor(value, `${property}.${key}`, context);\n      if (typeof CSS === \"undefined\" || !CSS.supports(\"color\", result))\n        throw layoutDiagnostic({\n          component: context.component,\n          property: `${property}.${key}`,\n          value,\n          algorithm: context.algorithm,\n          constraints: context.constraints,\n          reason: \"must be a supported concrete CSS color\",\n        });\n      return result;\n    };\n    const light = color(\"light\", \"white\"),\n      dark = color(\"dark\", \"black\");\n    return Object.freeze({\n      executor: filterBoundaryExecutor,\n      needsBackdrop: true,\n      reverseInfluence: (output) => ({ ...output }),\n      process: (source, windows, backdrop) => {\n        if (!backdrop)\n          throw new Error(\n            \"backdropContrast requires the current Canvas backdrop.\",\n          );\n        return processBackdropContrast(source, windows, backdrop, {\n          light,\n          dark,\n        });\n      },\n    } satisfies CustomPreparedFilter);\n  },\n  render: filterBoundaryExecutor.render,\n};\n/**\n * Recolors a receiving primitive and its descendants per pixel, using their combined alpha\n * as a mask. Chooses light below relative backdrop luminance 0.179129 and dark otherwise.\n * Samples already-painted content in the current Canvas target; transparent backdrop is\n * evaluated over white. Isolated/cached layers see their own local backdrop, not outer paint.\n * Requires OffscreenCanvas and WebGL2; performs no scene pixel readback. Geometry is unchanged.\n *\n * @param options - Optional signal-capable foreground colors; white and black by default.\n * See {@link PibblBackdropContrastFilterOptions}.\n * @returns An immutable descriptor for style.filter. See {@link PibblFilter}.\n */\nexport function backdropContrast(\n  options: PibblBackdropContrastFilterOptions = {},\n): PibblFilter {\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });\n  definitions.set(value, Object.freeze({ ...options }));\n  return value;\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AAEzB,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,OAEK;AACP,SAAS,+BAA+B;AASxC,MAAM,cAAc,oBAAI,QAGtB;AACF,MAAM,WAAgC;AAAA,EACpC,QAAQ,OAAO,UAAU,SAAS;AAChC,UAAM,UAAU,YAAY,IAAI,KAAK;AACrC,QAAI,CAAC;AACH,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,UAAM,QAAQ,CAAC,KAAuB,aAAqB;AACzD,YAAM,QAAQ,QAAQ,GAAG;AACzB,YAAMA,SACJ,UAAU,SAAY,WAAW,SAAS,KAAK,IAAI,MAAM,IAAI,IAAI;AACnE,YAAM,SAAS,cAAcA,QAAO,GAAG,QAAQ,IAAI,GAAG,IAAI,OAAO;AACjE,UAAI,OAAO,QAAQ,eAAe,CAAC,IAAI,SAAS,SAAS,MAAM;AAC7D,cAAM,iBAAiB;AAAA,UACrB,WAAW,QAAQ;AAAA,UACnB,UAAU,GAAG,QAAQ,IAAI,GAAG;AAAA,UAC5B,OAAAA;AAAA,UACA,WAAW,QAAQ;AAAA,UACnB,aAAa,QAAQ;AAAA,UACrB,QAAQ;AAAA,QACV,CAAC;AACH,aAAO;AAAA,IACT;AACA,UAAM,QAAQ,MAAM,SAAS,OAAO,GAClC,OAAO,MAAM,QAAQ,OAAO;AAC9B,WAAO,OAAO,OAAO;AAAA,MACnB,UAAU;AAAA,MACV,eAAe;AAAA,MACf,kBAAkB,CAAC,YAAY,EAAE,GAAG,OAAO;AAAA,MAC3C,SAAS,CAAC,QAAQ,SAAS,aAAa;AACtC,YAAI,CAAC;AACH,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AACF,eAAO,wBAAwB,QAAQ,SAAS,UAAU;AAAA,UACxD;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAgC;AAAA,EAClC;AAAA,EACA,QAAQ,uBAAuB;AACjC;AAYO,SAAS,iBACd,UAA8C,CAAC,GAClC;AACb,QAAM,QAAQ,OAAO,OAAO,EAAE,CAAC,qBAAqB,GAAG,SAAS,CAAC;AACjE,cAAY,IAAI,OAAO,OAAO,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpD,SAAO;AACT;",
+  "names": ["value"]
+}

package/dist/filters/displacement.js

@@ -22,7 +22,7 @@ const displacementExecutor = {
     }
     const identity = strengthValue === 0 && blurRadius === 0;
     const { x, y, width, height } = options.region;
-    if (![x, y, width, height].every(Number.isFinite) || width <= 0 || height <= 0) {
+    if (!(Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(width) && Number.isFinite(height)) || width <= 0 || height <= 0) {
       throw diagnostic(`${property}.region`, options.region, "must have finite coordinates and positive finite dimensions", context);
     }
     const map = isSignal(options.map) ? options.map.get() : options.map;

package/dist/filters/displacement.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/filters/displacement.ts"],
-  "sourcesContent": ["import { isSignal } from '../lib/signals/graph.js';\nimport { layoutDiagnostic } from '../lib/style/diagnostics.js';\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblDisplacementFilterOptions,\n  type PibblFilter,\n  type PibblFilterExecutor,\n  type PreparedPibblFilter,\n} from '../lib/style/filter-types.js';\nimport type { StyleResolutionContext } from '../lib/types.js';\nimport { borrowTextureRaster, validateTexturePaint } from '../lib/textures/texture-protocol.js';\nimport { processDisplacement } from './render-displacement-boundary.js';\nimport { filterBoundaryExecutor, type CustomPreparedFilter } from './filter-executor.js';\nimport { expandDisplacementInput } from './displacement-math.js';\n\nconst definitions = new WeakMap<PibblFilter, Readonly<PibblDisplacementFilterOptions>>();\nconst displacementExecutor: PibblFilterExecutor = {\n  prepare(value, property, context): PreparedPibblFilter {\n    const options = definitions.get(value);\n    if (!options) throw new Error('A displacement filter value was created by an incompatible Pibbl runtime.');\n    const strengthValue = isSignal(options.strength) ? options.strength.get() : options.strength;\n    if (typeof strengthValue !== 'number' || !Number.isFinite(strengthValue) || strengthValue < 0) {\n      throw diagnostic(`${property}.strength`, strengthValue, 'must be a finite nonnegative number', context);\n    }\n    const blurRadius = isSignal(options.blurRadius) ? options.blurRadius.get() : options.blurRadius ?? 0;\n    if (typeof blurRadius !== 'number' || !Number.isFinite(blurRadius) || blurRadius < 0) {\n      throw diagnostic(`${property}.blurRadius`, blurRadius, 'must be a finite nonnegative number', context);\n    }\n    const identity = strengthValue === 0 && blurRadius === 0;\n    const { x, y, width, height } = options.region;\n    if (![x, y, width, height].every(Number.isFinite) || width <= 0 || height <= 0) {\n      throw diagnostic(`${property}.region`, options.region, 'must have finite coordinates and positive finite dimensions', context);\n    }\n    const map = isSignal(options.map) ? options.map.get() : options.map;\n    try {\n      validateTexturePaint(map);\n      // Receiver preparation owns revision dependencies, before subtree execution\n      // changes signal tracking to descendant consumers.\n      if (!identity) borrowTextureRaster(map, () => undefined);\n    }\n    catch (error) {\n      throw diagnostic(`${property}.map`, map, error instanceof Error ? error.message : String(error), context);\n    }\n    const region = Object.freeze({ x, y, width, height });\n    return Object.freeze({\n      executor: filterBoundaryExecutor,\n      textureWarp: blurRadius === 0 ? Object.freeze({ map, strength: strengthValue, region }) : undefined,\n      reverseInfluence: (output, density) => expandDisplacementInput(output, strengthValue + blurRadius, density),\n      process: identity ? undefined : (source, windows) => {\n        try { return processDisplacement(source, windows, map, strengthValue, region, blurRadius); }\n        catch (error) {\n          const failure = diagnostic(property, { strength: strengthValue, region }, `displacement processing failed: ${error instanceof Error ? error.message : String(error)}`, context);\n          Object.defineProperty(failure, 'cause', { value: error });\n          throw failure;\n        }\n      },\n    } satisfies CustomPreparedFilter);\n  },\n  render: filterBoundaryExecutor.render,\n};\n\n/**\n * Creates a displacement filter descriptor for a primitive's style.filter list. Filtering changes\n * pixels without changing layout or hit geometry.\n *\n * @param options - Displacement texture, channel selection, and displacement scale. See\n * {@link PibblDisplacementFilterOptions} .\n * @returns A displacement filter descriptor for style.filter. See {@link PibblFilter}.\n *\n * @see {@link PibblDisplacementFilterOptions}\n * @see {@link PibblFilter}\n */\nexport function displacement(options: PibblDisplacementFilterOptions): PibblFilter {\n  const definition = Object.freeze({ map: options.map, strength: options.strength, blurRadius: options.blurRadius, region: Object.freeze({ ...options.region }) });\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: displacementExecutor });\n  definitions.set(value, definition);\n  return value;\n}\n\nfunction diagnostic(property: string, value: unknown, reason: string, context: Readonly<StyleResolutionContext>): Error {\n  return layoutDiagnostic({ component: context.component, property, value, algorithm: context.algorithm, constraints: context.constraints, reason });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { isSignal } from '../lib/signals/graph.js';\nimport { layoutDiagnostic } from '../lib/style/diagnostics.js';\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblDisplacementFilterOptions,\n  type PibblFilter,\n  type PibblFilterExecutor,\n  type PreparedPibblFilter,\n} from '../lib/style/filter-types.js';\nimport type { StyleResolutionContext } from '../lib/types.js';\nimport { borrowTextureRaster, validateTexturePaint } from '../lib/textures/texture-protocol.js';\nimport { processDisplacement } from './render-displacement-boundary.js';\nimport { filterBoundaryExecutor, type CustomPreparedFilter } from './filter-executor.js';\nimport { expandDisplacementInput } from './displacement-math.js';\n\nconst definitions = new WeakMap<PibblFilter, Readonly<PibblDisplacementFilterOptions>>();\nconst displacementExecutor: PibblFilterExecutor = {\n  prepare(value, property, context): PreparedPibblFilter {\n    const options = definitions.get(value);\n    if (!options) throw new Error('A displacement filter value was created by an incompatible Pibbl runtime.');\n    const strengthValue = isSignal(options.strength) ? options.strength.get() : options.strength;\n    if (typeof strengthValue !== 'number' || !Number.isFinite(strengthValue) || strengthValue < 0) {\n      throw diagnostic(`${property}.strength`, strengthValue, 'must be a finite nonnegative number', context);\n    }\n    const blurRadius = isSignal(options.blurRadius) ? options.blurRadius.get() : options.blurRadius ?? 0;\n    if (typeof blurRadius !== 'number' || !Number.isFinite(blurRadius) || blurRadius < 0) {\n      throw diagnostic(`${property}.blurRadius`, blurRadius, 'must be a finite nonnegative number', context);\n    }\n    const identity = strengthValue === 0 && blurRadius === 0;\n    const { x, y, width, height } = options.region;\n    if (\n      !(\n        Number.isFinite(x) &&\n        Number.isFinite(y) &&\n        Number.isFinite(width) &&\n        Number.isFinite(height)\n      ) ||\n      width <= 0 ||\n      height <= 0\n    ) {\n      throw diagnostic(`${property}.region`, options.region, 'must have finite coordinates and positive finite dimensions', context);\n    }\n    const map = isSignal(options.map) ? options.map.get() : options.map;\n    try {\n      validateTexturePaint(map);\n      // Receiver preparation owns revision dependencies, before subtree execution\n      // changes signal tracking to descendant consumers.\n      if (!identity) borrowTextureRaster(map, () => undefined);\n    }\n    catch (error) {\n      throw diagnostic(`${property}.map`, map, error instanceof Error ? error.message : String(error), context);\n    }\n    const region = Object.freeze({ x, y, width, height });\n    return Object.freeze({\n      executor: filterBoundaryExecutor,\n      textureWarp: blurRadius === 0 ? Object.freeze({ map, strength: strengthValue, region }) : undefined,\n      reverseInfluence: (output, density) => expandDisplacementInput(output, strengthValue + blurRadius, density),\n      process: identity ? undefined : (source, windows) => {\n        try { return processDisplacement(source, windows, map, strengthValue, region, blurRadius); }\n        catch (error) {\n          const failure = diagnostic(property, { strength: strengthValue, region }, `displacement processing failed: ${error instanceof Error ? error.message : String(error)}`, context);\n          Object.defineProperty(failure, 'cause', { value: error });\n          throw failure;\n        }\n      },\n    } satisfies CustomPreparedFilter);\n  },\n  render: filterBoundaryExecutor.render,\n};\n\n/**\n * Creates a displacement filter descriptor for a primitive's style.filter list. Filtering changes\n * pixels without changing layout or hit geometry.\n *\n * @param options - Displacement texture, channel selection, and displacement scale. See\n * {@link PibblDisplacementFilterOptions} .\n * @returns A displacement filter descriptor for style.filter. See {@link PibblFilter}.\n *\n * @see {@link PibblDisplacementFilterOptions}\n * @see {@link PibblFilter}\n */\nexport function displacement(options: PibblDisplacementFilterOptions): PibblFilter {\n  const definition = Object.freeze({ map: options.map, strength: options.strength, blurRadius: options.blurRadius, region: Object.freeze({ ...options.region }) });\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: displacementExecutor });\n  definitions.set(value, definition);\n  return value;\n}\n\nfunction diagnostic(property: string, value: unknown, reason: string, context: Readonly<StyleResolutionContext>): Error {\n  return layoutDiagnostic({ component: context.component, property, value, algorithm: context.algorithm, constraints: context.constraints, reason });\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/filters/emboss-gpu.d.ts

@@ -0,0 +1,4 @@
+import { ReflectionGpu, type ReflectionGpuCallbacks } from "./reflection-gpu.js";
+export declare class EmbossGpu extends ReflectionGpu {
+    constructor(callbacks?: Readonly<ReflectionGpuCallbacks>);
+}

package/dist/filters/emboss-gpu.js

@@ -0,0 +1,39 @@
+import {
+  ReflectionGpu
+} from "./reflection-gpu.js";
+const fragment = `#version 300 es
+precision highp float;
+uniform sampler2D scene, map;
+uniform vec2 logicalOrigin, logicalSize, mapOrigin, tileSize, direction;
+uniform float rotation, opacity, depth;
+in vec2 uv;
+out vec4 outputColor;
+vec2 coordinates(vec2 logical) {
+  vec2 p=logical-mapOrigin;
+  float c=cos(rotation),s=sin(rotation);
+  return vec2(c*p.x+s*p.y,-s*p.x+c*p.y)/tileSize;
+}
+float height(vec2 p) {
+  vec4 field=texture(map,coordinates(p));
+  return dot(field.rgb,vec3(.2126,.7152,.0722))*field.a;
+}
+void main() {
+  vec4 base=texture(scene,uv);
+  vec2 p=logicalOrigin+uv*logicalSize;
+  vec2 gradient=.5*vec2(height(p+vec2(1,0))-height(p-vec2(1,0)),height(p+vec2(0,1))-height(p-vec2(0,1)));
+  vec3 normal=normalize(vec3(-depth*gradient,1.));
+  vec3 light=normalize(vec3(direction*.8,1.));
+  float shade=max(0.,dot(normal,light))/light.z;
+  // A flat map is exactly neutral. Multiply premultiplied color, preserve alpha.
+  outputColor=vec4(clamp(base.rgb*mix(1.,shade,opacity),vec3(0),vec3(base.a)),base.a);
+}
+`;
+class EmbossGpu extends ReflectionGpu {
+  constructor(callbacks = {}) {
+    super(callbacks, fragment);
+  }
+}
+export {
+  EmbossGpu
+};
+//# sourceMappingURL=emboss-gpu.js.map

package/dist/filters/emboss-gpu.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/emboss-gpu.ts"],
+  "sourcesContent": ["import {\n  ReflectionGpu,\n  type ReflectionGpuCallbacks,\n} from \"./reflection-gpu.js\";\n\n// Reuses the existing GPU surface/cache ownership; this shader consumes scalar\n// height instead of the reflected-light operation's pre-encoded RG slopes.\nconst fragment = `#version 300 es\nprecision highp float;\nuniform sampler2D scene, map;\nuniform vec2 logicalOrigin, logicalSize, mapOrigin, tileSize, direction;\nuniform float rotation, opacity, depth;\nin vec2 uv;\nout vec4 outputColor;\nvec2 coordinates(vec2 logical) {\n  vec2 p=logical-mapOrigin;\n  float c=cos(rotation),s=sin(rotation);\n  return vec2(c*p.x+s*p.y,-s*p.x+c*p.y)/tileSize;\n}\nfloat height(vec2 p) {\n  vec4 field=texture(map,coordinates(p));\n  return dot(field.rgb,vec3(.2126,.7152,.0722))*field.a;\n}\nvoid main() {\n  vec4 base=texture(scene,uv);\n  vec2 p=logicalOrigin+uv*logicalSize;\n  vec2 gradient=.5*vec2(height(p+vec2(1,0))-height(p-vec2(1,0)),height(p+vec2(0,1))-height(p-vec2(0,1)));\n  vec3 normal=normalize(vec3(-depth*gradient,1.));\n  vec3 light=normalize(vec3(direction*.8,1.));\n  float shade=max(0.,dot(normal,light))/light.z;\n  // A flat map is exactly neutral. Multiply premultiplied color, preserve alpha.\n  outputColor=vec4(clamp(base.rgb*mix(1.,shade,opacity),vec3(0),vec3(base.a)),base.a);\n}\n`;\nexport class EmbossGpu extends ReflectionGpu {\n  constructor(callbacks: Readonly<ReflectionGpuCallbacks> = {}) {\n    super(callbacks, fragment);\n  }\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAIP,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BV,MAAM,kBAAkB,cAAc;AAAA,EAC3C,YAAY,YAA8C,CAAC,GAAG;AAC5D,UAAM,WAAW,QAAQ;AAAA,EAC3B;AACF;",
+  "names": []
+}

package/dist/filters/emboss.d.ts

@@ -0,0 +1,32 @@
+import type { SignalValue } from "../lib/signals/types.js";
+import { type PibblFilter } from "../lib/style/filter-types.js";
+import { type TexturePaint } from "../lib/textures/texture-protocol.js";
+/** Directional lighting of grayscale texture height. See {@link emboss}. */
+export interface PibblEmbossFilterOptions {
+    /** Local texture placement region with finite coordinates and positive dimensions. See {@link TexturePaint}. */
+    readonly region: Readonly<{
+        /** Horizontal origin in local logical coordinates. See {@link PibblEmbossFilterOptions}. */
+        x: number;
+        /** Vertical origin in local logical coordinates. See {@link PibblEmbossFilterOptions}. */
+        y: number;
+        /** Positive logical region width. See {@link PibblEmbossFilterOptions}. */
+        width: number;
+        /** Positive logical region height. See {@link PibblEmbossFilterOptions}. */
+        height: number;
+    }>;
+    /** Height range in logical pixels, finite 0–32; default 3. See {@link emboss}. */
+    readonly depth?: SignalValue<number>;
+    /** Lighting strength, finite 0–1; default 1. Zero bypasses processing. See {@link emboss}. */
+    readonly strength?: SignalValue<number>;
+    /** Nonzero finite direction toward the light in local coordinates; default [-0.6, -0.8]. See {@link emboss}. */
+    readonly direction?: readonly [number, number];
+}
+/**
+ * Lights captured pixels using normals derived from a grayscale texture height map.
+ * Flat heights are neutral; opposing slopes brighten and darken without changing alpha or geometry.
+ * @param map - Mounted height texture, luminance times alpha; white is high. See {@link TexturePaint}.
+ * @param options - Local placement, height depth, strength, and light direction. See {@link PibblEmbossFilterOptions}.
+ * @returns A filter descriptor for style.filter. See {@link PibblFilter}.
+ * @see {@link PibblEmbossFilterOptions}
+ */
+export declare function emboss(map: SignalValue<TexturePaint>, options: PibblEmbossFilterOptions): PibblFilter;