shaders 3.1.462 → 3.2.464

package/dist/core/std/paint/noise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise.d.ts","sourceRoot":"","sources":["../../../src/std/paint/noise.ts"],"names":[],"mappings":"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"}

package/dist/core/std/paint/patterns.d.ts

@@ -0,0 +1,319 @@
+import { Expr, GpuFragmentParams, GpuMapSampleUVs } from '../../gpu/contract';
+import { RttFilterParams } from '../../gpu/scaffolds/rttFilter';
+import { GatherEffect } from '../types';
+import { PropRef } from '../values';
+
+/** A generator paint part — what `StdGeneratorDefinition.paint` accepts. */
+export type PatternPaint = (params: GpuFragmentParams) => Expr;
+/** What a paint slot accepts: a prop binding or another paint part. */
+export type PaintSlot = PropRef | PatternPaint;
+/**
+ * A lattice frame's coordinate convention. `'flippedY'` = image-style Y-down, positive rotation
+ * counter-clockwise; `'clockwise'` = Y as-is, positive rotation clockwise; `'plain'` = Y as-is,
+ * positive rotation counter-clockwise. The convention is part of each pattern's look — the
+ * shader file states it alongside the cell count.
+ */
+export type CellFrameConvention = 'flippedY' | 'clockwise' | 'plain';
+/**
+ * The lattice frame part: maps the paint UV (uvContext-aware) into rotated, aspect-corrected
+ * lattice space, scaled to `cells` lattice units. Everything drawn IN the cells composes on top.
+ */
+export declare function cellFrame(slots: {
+    cells: PropRef;
+    rotation: PropRef;
+    convention: CellFrameConvention;
+}): PatternPaint;
+/** The per-cell brightness-jitter part: scale a fill's RGB by a variation factor (alpha untouched). */
+export declare function vary(color: PaintSlot, factor: PaintSlot): PatternPaint;
+/** The stroke-over-fill part: mix `fill` → `stroke` by the stroke mask in the `space` colour space. */
+export declare function strokeOver(layers: {
+    fill: PaintSlot;
+    stroke: PaintSlot;
+    mask: PaintSlot;
+    space?: PropRef;
+}): PatternPaint;
+/**
+ * Sample the given mapped props at the CELL CENTRE rather than the fragment position, so a
+ * mapped size/thickness transitions as whole cells instead of being clipped at map-source
+ * boundaries. `rotation` (degrees) rotates the lattice about the canvas centre before snapping.
+ * Uses the raw canvas UV/viewport (the global, not effectiveViewportSize) — declare it on the
+ * definition's `mapSampleUVs` field.
+ */
+export declare function sampleMapsAtCellCentres(slots: {
+    cells: PropRef;
+    rotation?: PropRef;
+    props: string[];
+}): GpuMapSampleUVs;
+/** Pair a colour's RGB with a separately built alpha. */
+export declare function withAlpha(color: PaintSlot, alpha: PaintSlot): PatternPaint;
+/** Read a colour's alpha channel. */
+export declare function alphaOf(color: PaintSlot): PatternPaint;
+/** Read a colour's RGB channels. */
+export declare function rgbOf(color: PaintSlot): PatternPaint;
+/** Multiply two slot values. */
+export declare function times(a: PaintSlot, b: PaintSlot): PatternPaint;
+/** Linear mix `from` → `to` by `amount` (component-wise, no colour-space handling). */
+export declare function mixOf(from: PaintSlot, to: PaintSlot, amount: PaintSlot): PatternPaint;
+/** Finish an RGB value as a fully opaque colour. */
+export declare function opaque(rgb: PaintSlot): PatternPaint;
+/**
+ * Checker cells: the analytically anti-aliased checker blend factor (Quilez 2D filter over the
+ * screen-space footprint). `cells` counts cells along the canvas height (square cells).
+ */
+export declare function checkerCells(slots: {
+    cells: PropRef;
+    softness: PropRef;
+}): PatternPaint;
+/**
+ * Stripe bands: the analytically anti-aliased directional stripe mask (Quilez 1D filter,
+ * `balance` as the duty threshold), scrolled by the node's accumulated animation time plus
+ * `offset`. Requires `animatedTime: {speed}` on the definition.
+ */
+export declare function stripeBands(slots: {
+    angle: PropRef;
+    density: PropRef;
+    balance: PropRef;
+    softness: PropRef;
+    offset: PropRef;
+}): PatternPaint;
+/**
+ * Zigzag bands: the fwidth-anti-aliased chevron stripe mask, scrolled by the node's accumulated
+ * animation time plus `offset`. Requires `animatedTime: {speed}` on the definition.
+ */
+export declare function zigzagBands(slots: {
+    count: PropRef;
+    angle: PropRef;
+    balance: PropRef;
+    softness: PropRef;
+    offset: PropRef;
+}): PatternPaint;
+/**
+ * Ring waves: the mask of concentric rings emanating from `center`, animated by the node's
+ * accumulated time plus `phase`. Requires `animatedTime: {speed}` on the definition.
+ */
+export declare function ringWaves(slots: {
+    center: PropRef;
+    frequency: PropRef;
+    thickness: PropRef;
+    softness: PropRef;
+    phase: PropRef;
+}): PatternPaint;
+/**
+ * Falling streaks: directional streaks with per-column random speed/phase and a rounded leading
+ * cap, driven by the node's accumulated animation time. `mask` is the streak coverage, `fade`
+ * the lead→trail position within a streak. Requires `animatedTime: {speed}` on the definition.
+ */
+export declare function fallingStreaks(slots: {
+    angle: PropRef;
+    density: PropRef;
+    speedVariance: PropRef;
+    trailLength: PropRef;
+    strokeWidth: PropRef;
+    rounding: PropRef;
+    balance: PropRef;
+}): {
+    mask: PatternPaint;
+    fade: PatternPaint;
+};
+/**
+ * Dot lattice: the coverage of a square lattice of anti-aliased discs with optional brick-style
+ * row stagger, per-row animated drift (the node's accumulated time × per-row random speed), and
+ * a per-dot twinkle on the global clock. Requires `animatedTime: {speed}` on the definition.
+ */
+export declare function dotLattice(slots: {
+    density: PropRef;
+    dotSize: PropRef;
+    offset: PropRef;
+    speedVariance: PropRef;
+    twinkle: PropRef;
+}): PatternPaint;
+/**
+ * Grid lines drawn in a lattice frame: Quilez axis integrals over the dpdx/dpdy footprint.
+ * `lines` is the line mask, `shade` the per-cell variation factor for the cell fill.
+ */
+export declare function gridLines(slots: {
+    frame: PatternPaint;
+    thickness: PropRef;
+    softness: PropRef;
+    variation: PropRef;
+}): {
+    lines: PatternPaint;
+    shade: PatternPaint;
+};
+/**
+ * Honeycomb lines drawn in a lattice frame (pointy-top hexagons). `lines` is the line mask,
+ * `shade` the per-cell variation factor for the cell fill.
+ */
+export declare function hexLines(slots: {
+    frame: PatternPaint;
+    thickness: PropRef;
+    softness: PropRef;
+    variation: PropRef;
+}): {
+    lines: PatternPaint;
+    shade: PatternPaint;
+};
+/**
+ * Skewed equilateral-triangle lines drawn in a lattice frame, with per-row animated drift.
+ * `lines` is the line mask, `shade` the per-cell variation factor. Requires
+ * `animatedTime: {speed}` on the definition.
+ */
+export declare function triangleLines(slots: {
+    frame: PatternPaint;
+    thickness: PropRef;
+    softness: PropRef;
+    variation: PropRef;
+    speedVariance: PropRef;
+}): {
+    lines: PatternPaint;
+    shade: PatternPaint;
+};
+/**
+ * Brick courses: staggered rows with mortar gaps, optional rotation, static offset, and per-row
+ * animated drift (the node's accumulated time). `bricks` is the brick coverage mask, `shade`
+ * the per-brick variation factor. The field stays fused with its own rotated frame — the frame's
+ * aspect feeds the mortar thickness compensation. Requires `animatedTime: {speed}` on the
+ * definition.
+ */
+export declare function brickCourses(slots: {
+    cellsX: PropRef;
+    cellsY: PropRef;
+    mortar: PropRef;
+    softness: PropRef;
+    variation: PropRef;
+    rotation: PropRef;
+    offset: PropRef;
+    speedVariance: PropRef;
+    seed: PropRef;
+}): {
+    bricks: PatternPaint;
+    shade: PatternPaint;
+};
+/**
+ * Truchet arcs drawn in a lattice frame: quarter-circle arc tiles, orientation hashed per tile
+ * (`seed` reshuffles the maze). Returns the arc line mask.
+ */
+export declare function truchetArcs(slots: {
+    frame: PatternPaint;
+    thickness: PropRef;
+    softness: PropRef;
+    seed: PropRef;
+}): PatternPaint;
+/**
+ * Weave threads drawn in a lattice frame: interlaced horizontal/vertical thread bands with a
+ * checkerboard over-under rule, compositing `colors[0]` (horizontal) and `colors[1]` (vertical)
+ * by per-thread alpha weight — not a colour-space mix, so there is no `space` slot.
+ */
+export declare function weaveThreads(slots: {
+    frame: PatternPaint;
+    gap: PropRef;
+    /** `[horizontal, vertical]` thread colours. */
+    colors: [PropRef, PropRef];
+}): PatternPaint;
+/**
+ * Rhombille (tumbling-blocks) faces drawn in a lattice frame — three shaded rhombus faces per
+ * hexagon read as a 3D cube. `random` is the per-cube colour hash, `tone` the face shading
+ * factor, `wire` the edge-line mask.
+ */
+export declare function isoCubeFaces(slots: {
+    frame: PatternPaint;
+    thickness: PropRef;
+    softness: PropRef;
+}): {
+    random: PatternPaint;
+    tone: PatternPaint;
+    wire: PatternPaint;
+};
+/**
+ * Halftone plate part: the rotated dot-screen coverage for one ink plate — dot size follows
+ * `intensity` (the plate's ink value at this pixel), spaced by `frequency` at the plate's screen
+ * `angle`.
+ */
+export declare function dotScreenMask(uv: Expr, aspect: Expr, angle: Expr, intensity: Expr, frequency: Expr): Expr;
+/**
+ * Halftone plate part: subtractive ink lay-down — white where the plate leaves paper bare,
+ * fading toward the ink colour (× ink alpha) where the dot covers. Plates multiply together.
+ */
+export declare function inkTransmission(inkColor: Expr, inkMask: Expr): Expr;
+/**
+ * Classic halftone gather recipe: the child sampled once (straight alpha), its brightness
+ * modulating a single rotated dot plate.
+ */
+export declare function dotScreen(slots: {
+    angle: PropRef;
+    frequency: PropRef;
+}): GatherEffect;
+/** One ink plate of a {@link cmykPress}: which CMYK channel it prints, at which screen angle, in which ink. */
+export interface InkPlateSpec {
+    readonly channel: 'cyan' | 'magenta' | 'yellow' | 'black';
+    readonly screenAngle: PropRef;
+    readonly ink: PropRef;
+}
+export declare function inkPlate(spec: InkPlateSpec): InkPlateSpec;
+/**
+ * CMYK press gather recipe: one subtractive plate per ink, laid down in order. Each plate samples
+ * the child at its own registration offset around `misprintAngle` (quarter turns per plate index;
+ * mis-registration shows as colour fringing), reads its CMYK channel, screens it through
+ * `dotScreenMask`, and multiplies its `inkTransmission` into the paper. Alpha follows the
+ * un-offset centre sample; every tap is straight-alpha.
+ */
+export declare function cmykPress(slots: {
+    paper: PropRef;
+    frequency: PropRef;
+    misprint: PropRef;
+    misprintAngle: PropRef;
+    plates: InkPlateSpec[];
+}): GatherEffect;
+/**
+ * Compile-time recipe switch: pick a whole gather recipe from a structural enum prop. `read`
+ * maps the raw compile-time value (robust to a pre-transform string) to a case key. All cases
+ * must share their alpha discipline and carry no setup hooks.
+ */
+export declare function chosenBy<K extends string>(prop: PropRef, read: (raw: unknown) => K, recipes: Record<K, GatherEffect>): GatherEffect;
+/** One post-sample gather stage: a value derived from the child RTT. */
+export type GatherStage = (params: RttFilterParams) => Expr;
+/**
+ * The dither grid frame: the shared cell geometry of a pixel-grid screen. `coord` is the dither
+ * cell coordinate, `source` the child sampled once per cell (the pixellated source colour). The
+ * grid is sized against the LOGICAL (authored-frame) resolution so the dot count stays constant
+ * under infinite-canvas resolution scaling.
+ */
+export interface PixelGrid {
+    readonly size: PropRef;
+    readonly coord: GatherStage;
+    readonly source: GatherStage;
+}
+export declare function pixelGrid(slots: {
+    size: PropRef;
+}): PixelGrid;
+/**
+ * Ordered-dither part: the threshold FIELD for a compile-time pattern mode — the closed-form
+ * Bayer 2/4/8 or clustered-dot lattice values, or the blue/white-noise hashes, at the dither
+ * cell coordinate. Feed it to `ditherOrderedResult` to quantise a luminance against it.
+ * (Floyd–Steinberg is not a threshold field — its quantisation diffuses error serially.)
+ */
+export declare function orderedThreshold(pattern: number, coord: Expr): Expr;
+/**
+ * The quantise stage: the 0..1 dither result for the grid cell. The ordered modes compose an
+ * `orderedThreshold` field with the cell luminance; the compile-time Floyd–Steinberg mode has no
+ * threshold field — it samples the 64 block-cell luminances and runs its tile-confined serpentine
+ * error diffusion, reading off this fragment's cell.
+ */
+export declare function quantise(slots: {
+    grid: PixelGrid;
+    pattern: PropRef;
+    threshold: PropRef;
+    spread: PropRef;
+}): GatherStage;
+/**
+ * The dither compose gather recipe: colour the quantised `levels`. The compile-time `mode`
+ * branches — custom mixes `colors[0]`→`colors[1]`, source darkens/brightens the grid's own
+ * pixellated child colour. Every tap is straight-alpha.
+ */
+export declare function ditherInks(slots: {
+    grid: PixelGrid;
+    levels: GatherStage;
+    mode: PropRef;
+    colors: [PropRef, PropRef];
+}): GatherEffect;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/core/std/paint/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/std/paint/patterns.ts"],"names":[],"mappings":"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"}

package/dist/core/std/paint/scenic.d.ts

@@ -0,0 +1,111 @@
+import { Expr, GpuFragmentParams } from '../../gpu/contract';
+import { PropRef } from '../values';
+
+/** A lowered scenic value — evaluate against the composition params. */
+export type ScenicValue = (params: GpuFragmentParams) => Expr;
+/**
+ * The fused aurora curtain kernel: up to four layered curtains with vertical rays and flowing
+ * light, animated on the definition's clock. Yields `vec3(lowToMid, midToHigh, brightness)` —
+ * the two ladder factors and the glow gain.
+ */
+export declare function auroraField(slots: {
+    seed: PropRef;
+    waviness: PropRef;
+    rayDensity: PropRef;
+    height: PropRef;
+    center: PropRef;
+    balance: PropRef;
+    intensity: PropRef;
+    curtainCount: PropRef;
+}): ScenicValue;
+/**
+ * A 3-colour ladder A → B (by `t1`) → C (by `t2`) in the compile-time colour `space`, chaining
+ * `mixColorsVariants[mode]`.
+ */
+export declare function colorLadder3(slots: {
+    a: PropRef;
+    b: PropRef;
+    c: PropRef;
+    space: PropRef;
+}): (t1: Expr, t2: Expr, params: GpuFragmentParams) => Expr;
+/** Scale a colour by an aurora brightness field (the glow composite). */
+export declare function auroraGlow(color: Expr, brightness: Expr): Expr;
+/**
+ * The fused mesh-gradient field kernel: golden-spiral colour anchors IDW-blended through a
+ * domain-warped, swirled field, animated on the definition's clock. Yields the palette
+ * parameter T.
+ */
+export declare function meshField(slots: {
+    count: PropRef;
+    smoothness: PropRef;
+    variation: PropRef;
+    swirl: PropRef;
+    drift: PropRef;
+    seed: PropRef;
+}): ScenicValue;
+/** Palette wrapping over a field parameter (identity at 0) — seams sweep the palette's hues. */
+export declare function paletteWrap(slots: {
+    wrapping: PropRef;
+}): (t: Expr, params: GpuFragmentParams) => Expr;
+/**
+ * The standard multi-stop / two-colour palette, read from the definition's standard palette
+ * props (colorA/colorB/stops/colorSpace). The wrapped coordinate is consumed once — the stops
+ * loop takes it as a fn parameter.
+ */
+export declare function standardPalette(t: Expr, params: GpuFragmentParams): Expr;
+/** The always-on output dither against the composed UV (hides ramp banding). */
+export declare function outputDither(color: Expr, params: GpuFragmentParams): Expr;
+/**
+ * The fused liquid-silk kernel: rotate/warp/shade over six noise reads, animated on the
+ * definition's clock. Yields `vec3(t1, t2, litScale)` — the two blend factors and the
+ * fold-lighting scale. Bind the result as a local: `Expr.member()` re-emits its whole
+ * subtree, so un-hoisted each factor read would re-emit the full domain-warp body.
+ */
+export declare function flowingFactors(slots: {
+    distortion: PropRef;
+    seed: PropRef;
+}): ScenicValue;
+/**
+ * A 2D 4-colour blend: row1 = A→B by `t1`, row2 = C→D by `t1`, base = row1→row2 by `t2`, in
+ * the compile-time colour `space`. For a non-linear space the four endpoint conversions are
+ * pixel-invariant, so the part's per-frame driver preconverts them (dirty-keyed) into the
+ * `convA`–`convD` vec3 extraFields the definition declares, and the GPU mixes the
+ * preconverted values with a single back-conversion.
+ */
+export declare function quadBlend(slots: {
+    a: PropRef;
+    b: PropRef;
+    c: PropRef;
+    d: PropRef;
+    space: PropRef;
+}): (t1: Expr, t2: Expr, params: GpuFragmentParams) => Expr;
+/** Scale a colour by the fold-lighting factor (the flowing-gradient composite). */
+export declare function foldLighting(base: Expr, litScale: Expr): Expr;
+/**
+ * The fused multi-light studio rig: key/fill/back spotlights over wall/floor cove geometry
+ * with bounce, plus four drifting neutral ambient glows whose orbits are integrated on the
+ * CPU each frame into the `ambPosA`/`ambPosB`/`ambSizeSq` vec4 extraFields the definition
+ * declares. Yields the light field a surface colour is lit by.
+ */
+export declare function studioLightRig(slots: {
+    brightness: PropRef;
+    keyColor: PropRef;
+    keyIntensity: PropRef;
+    keySoftness: PropRef;
+    fillColor: PropRef;
+    fillIntensity: PropRef;
+    fillSoftness: PropRef;
+    fillAngle: PropRef;
+    backColor: PropRef;
+    backIntensity: PropRef;
+    backSoftness: PropRef;
+    center: PropRef;
+    lightTarget: PropRef;
+    wallCurvature: PropRef;
+    ambientIntensity: PropRef;
+    ambientSpeed: PropRef;
+    seed: PropRef;
+}): ScenicValue;
+/** Light a surface colour by a light field, darkened by a vignette mask. */
+export declare function litSurface(color: PropRef, light: Expr, vignette: Expr, params: GpuFragmentParams): Expr;
+//# sourceMappingURL=scenic.d.ts.map

package/dist/core/std/paint/scenic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenic.d.ts","sourceRoot":"","sources":["../../../src/std/paint/scenic.ts"],"names":[],"mappings":"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"}

package/dist/core/std/paint/volume.d.ts

@@ -0,0 +1,104 @@
+import { Expr } from '../../gpu/contract';
+import { SurfaceFrame, SurfaceField } from './materials';
+
+export interface InteriorRay {
+    /** Chord entry depth along the view (volumetric taps carry it in `.w`; flat shapes enter at 0). */
+    entry: Expr;
+    /** Chord length (the shared optical-thickness reading, scaled by the material's factor). */
+    length: Expr;
+    /** The in-plane interior position at chord depth `z` — origin sheared along the view. */
+    at(z: Expr): {
+        x: Expr;
+        y: Expr;
+    };
+}
+/**
+ * The ray a shape's interior is sampled along: entry depth + chord length, and `at(z)` —
+ * the position any interior content (gas samples, star planes, backdrops) lives at for a
+ * given depth. `shear` sets how strongly deeper samples slide along the view ray's
+ * in-plane direction (the perspective parallax of looking INTO a solid).
+ */
+export declare function interiorRay(field: SurfaceField, frame: SurfaceFrame, opts: {
+    origin: {
+        x: Expr;
+        y: Expr;
+    };
+    view?: Expr;
+    shear?: number;
+    lengthScale?: number;
+}): InteriorRay;
+/**
+ * A content plane at a fixed depth along an interior ray, counter-panned by a rotation
+ * sensor so it parallaxes like scenery behind a window: rotating the shape pans the
+ * plane, deeper planes drifting further (`panRate`).
+ */
+export declare function parallaxPlane(ray: InteriorRay, opts: {
+    depth: number;
+    pan?: {
+        x: Expr;
+        y: Expr;
+    };
+    panRate?: number;
+    hint?: string;
+}): {
+    x: Expr;
+    y: Expr;
+    z: Expr;
+};
+/**
+ * The house turbulence: a billowing 3D cloud density at an interior point — one-octave
+ * domain warp (the folds) over a 3-octave fbm, drifting on `drift` and decorrelated per
+ * axis by `seed`. Returns the composed `density` plus the raw `mid`/`fine` octaves, which
+ * double as free detail fields (dust bands, ridge filaments) at zero extra noise cost.
+ */
+export declare function turbulentMedium(p: {
+    x: Expr;
+    y: Expr;
+    z: Expr;
+}, opts: {
+    frequency: Expr;
+    drift?: Expr;
+    seed?: Expr;
+    billow?: Expr;
+    hint?: string;
+}): {
+    density: Expr;
+    mid: Expr;
+    fine: Expr;
+};
+export interface VolumeMarchStep {
+    /** Step index (build-time). */
+    i: number;
+    /** Chord fraction at the step centre, 0..1 (build-time). */
+    t: number;
+    /** Depth along the chord (entry + length·(t + jitter)), locals-bound. */
+    z: Expr;
+}
+/**
+ * Front-to-back emission/absorption march: `steps` samples along the chord, each
+ * contributing `emit · transmittance (· emissionGain)` and attenuating the transmittance
+ * by `exp(−absorb)`. Absorption is per-channel (a vec3 `absorb` tints what lies behind —
+ * interstellar reddening, coloured glass, murky water). The unrolled loop costs exactly
+ * what the sample callback costs; banding is bought off with `jitter` (a per-pixel hash
+ * offset in chord-fraction units), not more steps.
+ *
+ * Returns the accumulated colour and the surviving transmittance — multiply anything
+ * BEHIND the medium (backgrounds, star planes) by the latter.
+ */
+export declare function volumeMarch(opts: {
+    steps: number;
+    entry: Expr;
+    length: Expr;
+    /** Per-pixel offset added to each step's chord fraction (banding → grain). */
+    jitter?: Expr;
+    /** Per-step emission normalizer (typically `k / steps` so tiers match in brightness). */
+    emissionGain?: Expr;
+    hint?: string;
+}, sample: (step: VolumeMarchStep) => {
+    emit: Expr;
+    absorb: Expr;
+}): {
+    color: Expr;
+    transmittance: Expr;
+};
+//# sourceMappingURL=volume.d.ts.map

package/dist/core/std/paint/volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../../src/std/paint/volume.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,oBAAoB,CAAA;AAG5C,OAAO,KAAK,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,aAAa,CAAA;AAG3D,MAAM,WAAW,WAAW;IACxB,mGAAmG;IACnG,KAAK,EAAE,IAAI,CAAA;IACX,4FAA4F;IAC5F,MAAM,EAAE,IAAI,CAAA;IACZ,yFAAyF;IACzF,EAAE,CAAC,CAAC,EAAE,IAAI,GAAG;QAAC,CAAC,EAAE,IAAI,CAAC;QAAC,CAAC,EAAE,IAAI,CAAA;KAAC,CAAA;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IAAC,MAAM,EAAE;QAAC,CAAC,EAAE,IAAI,CAAC;QAAC,CAAC,EAAE,IAAI,CAAA;KAAC,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC,GACtF,WAAW,CAoBb;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE;QAAC,CAAC,EAAE,IAAI,CAAC;QAAC,CAAC,EAAE,IAAI,CAAA;KAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GACjF;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAA;CAAC,CAW7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,CAAC,EAAE;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAA;CAAC,EAC9B,IAAI,EAAE;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GACjF;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,CA8BxC;AAED,MAAM,WAAW,eAAe;IAC5B,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAA;IACT,yEAAyE;IACzE,CAAC,EAAE,IAAI,CAAA;CACV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACvB,IAAI,EAAE;IACF,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,IAAI,CAAA;IACX,MAAM,EAAE,IAAI,CAAA;IACZ,8EAA8E;IAC9E,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,yFAAyF;IACzF,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB,EACD,MAAM,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAC,GAC9D;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,IAAI,CAAA;CAAC,CAepC"}

package/dist/core/std/shape.d.ts

@@ -0,0 +1,22 @@
+import { Expr } from '../gpu/contract';
+
+type Val = Expr | number;
+export declare const circle: (x: Val, y: Val, radius: Val) => Expr;
+export declare const ellipse: (x: Val, y: Val, radiusX: Val, radiusY: Val) => Expr;
+export declare const roundedRect: (x: Val, y: Val, width: Val, height: Val, rounding: Val) => Expr;
+export declare const polygon: (x: Val, y: Val, radius: Val, sides: Val) => Expr;
+export declare const star: (x: Val, y: Val, outerRadius: Val, sides: Val, innerRatio: Val) => Expr;
+export declare const flower: (x: Val, y: Val, outerRadius: Val, sides: Val, innerRatio: Val) => Expr;
+export declare const heart: (x: Val, y: Val, radius: Val) => Expr;
+export declare const cross: (x: Val, y: Val, size: Val, thickness: Val, rounding: Val) => Expr;
+export declare const ring: (x: Val, y: Val, radius: Val, thickness: Val) => Expr;
+export declare const vesica: (x: Val, y: Val, radius: Val, spread: Val) => Expr;
+export declare const crescent: (x: Val, y: Val, outerRadius: Val, innerRatio: Val, offset: Val) => Expr;
+export declare const trapezoid: (x: Val, y: Val, topWidth: Val, bottomWidth: Val, height: Val) => Expr;
+export declare const teardrop: (x: Val, y: Val, radius: Val, height: Val) => Expr;
+export declare const parallelogram: (x: Val, y: Val, width: Val, height: Val, skew: Val) => Expr;
+export declare const arc: (x: Val, y: Val, radius: Val, halfAngle: Val) => Expr;
+/** Degrees of aperture → the half-angle in radians `arc` takes (π/360). */
+export declare const APERTURE_TO_HALF_ANGLE = 0.008726646259971648;
+export {};
+//# sourceMappingURL=shape.d.ts.map

package/dist/core/std/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/std/shape.ts"],"names":[],"mappings":"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"}

package/dist/core/std/signal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * std — signal nouns. The first slice: the pointer signals a cursor-driven
+ * simulation needs. Pointer signals carry POLICY as data — the teleport guard is a
+ * per-shader aesthetic decision (ON for ripple/RD-class sims, OFF for smoke/trail-class),
+ * and the speed clamp names the gating curve.
+ */
+/** The pointer position signal. `teleportGuard: 'on'` zeroes velocity on a jump frame. */
+export interface PointerSignal {
+    readonly kind: 'pointer';
+    readonly teleportGuard: 'on' | 'off';
+}
+export declare function pointer(opts?: {
+    teleportGuard?: 'on' | 'off';
+}): PointerSignal;
+/** The pointer's per-second speed, clamped to `max` (the splat-amount gating curve). */
+export interface PointerSpeedSignal {
+    readonly kind: 'pointerSpeed';
+    readonly max: number;
+}
+export declare function pointerSpeed(opts?: {
+    max?: number;
+}): PointerSpeedSignal;
+//# sourceMappingURL=signal.d.ts.map

package/dist/core/std/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/std/signal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,IAAI,GAAG,KAAK,CAAA;CACvC;AAED,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE;IAAC,aAAa,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;CAAC,GAAG,aAAa,CAE5E;AAED,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,kBAAkB,CAEtE"}