vireglass 1.0.0 → 2.0.0

package/dist/adapters-BPB0D5nr.d.cts

@@ -1,357 +0,0 @@
-import { V as VireGlassOptics, n as VireGlassDebugMode } from './material-CkUHUBoy.cjs';
-
-/** Glass shape in dp. Circle and capsule are special cases of a rounded rectangle. */
-type VireGlassGeometry = {
-    width: number;
-    height: number;
-    cornerRadius: number;
-};
-declare const circleGeometry: (size: number) => VireGlassGeometry;
-declare const capsuleGeometry: (width: number, height: number) => VireGlassGeometry;
-declare const roundedRectGeometry: (width: number, height: number, cornerRadius: number) => VireGlassGeometry;
-declare const halfMinDp: (g: VireGlassGeometry) => number;
-/** Viewport margin for a drop that overshoots past the finger: a fraction of the element's half
- *  size beyond the drag travel itself. The drop overshoots the body by no more than `dragLimit`,
- *  and stitching adds smoothing on top of that — this term covers it too. */
-declare const MAX_STRETCH = 0.34;
-declare const sizeGain: (g: VireGlassGeometry) => number;
-/** A bevel wider than this fraction of the half-size breaks the SDF: the roundings converge in
- *  the middle. */
-declare const MAX_BEVEL_FRACTION = 0.65;
-declare const bevelFraction: (g: VireGlassGeometry, o: VireGlassOptics) => number;
-declare const bevelDp: (g: VireGlassGeometry, o: VireGlassOptics) => number;
-declare const thicknessDp: (g: VireGlassGeometry, o: VireGlassOptics) => number;
-/** Glass height right at the silhouette, a fraction of thickness: without it there's nothing at
- *  the edge to bend the ray. */
-declare const RIM_FRACTION = 0.85;
-declare const rimDp: (g: VireGlassGeometry, o: VireGlassOptics) => number;
-/** Bigger element, deeper and wider shadow (M 7:14). */
-declare const shadowReachDp: (g: VireGlassGeometry) => number;
-/** How far the second morph shape reaches past the first one's bounds. Without this margin the
- *  fused shape gets clipped by the canvas edge and the experiment shows the wrong thing. */
-declare function morphReachDp(g: VireGlassGeometry, morph?: {
-    offsetX: number;
-    offsetY: number;
-    width: number;
-    height: number;
-    smoothing: number;
-}): number;
-/**
- * Margin around the lens view on each side: beyond it, the shader has nothing to sample.
- *
- * FOUR things have to fit in here. The refraction sample with aberrations. The blur radius —
- * it also samples around the point. The gather radius — the rim picks it up from outside the
- * shape, and without the margin it goes black exactly where it should be catching the
- * surroundings. And drag travel: the lens view moves with the finger, but its bounds don't, and
- * the sample falls off the edge, which is how layers from under the glass leak through.
- */
-declare function lensPadDp(g: VireGlassGeometry, o: VireGlassOptics, morph?: Parameters<typeof morphReachDp>[1], dragLimit?: number): number;
-/**
- * Margin around the surface canvas: the shadow reaches outside the shape, and dragging shifts it
- * further still.
- *
- * The multiplier is smaller than the shadow's full reach: under the finger, the shader for a
- * rising element multiplies the radius by 1.55, and the very end of that tail falls outside the
- * margin. Left that way on purpose — at the margin's edge it's at 1.2% alpha (2.5% before the
- * shadow was softened), and raising the multiplier means growing every surface view's area. If
- * that tail ever shows up on a device, fix it here.
- */
-declare function surfacePadDp(g: VireGlassGeometry, dragLimit?: number, morph?: Parameters<typeof morphReachDp>[1]): number;
-declare function shadowOpacity(busy: number): number;
-/** Same thing for platforms where the measurement flows through state: quantized coarsely, like
- *  the ambient color, otherwise every probe sample would trigger a surface repaint. */
-declare function shadowOpacityFrom(sample: {
-    busy: number;
-}): number;
-
-/**
- * REFERENCE CANVASES — the set that both benches draw and that the gates run against.
- *
- * There used to be three kinds of canvas, each in a different place: the web bench had its own
- * zones, the mobile lab had its own, and a third set lived inside `check-optics.mjs`, invisible
- * to everyone else. So the gate measured one thing, the eye looked at another, and there was
- * nothing to confirm the question "does Android differ?" against.
- *
- * The canvases are described as DATA, not drawing code: the canvas and the native views draw
- * differently, but both platforms lay out the same list of layers. Everything is in dp and in
- * fractions — fractions of the stage kept the stripes the same relative thickness on benches of
- * different sizes.
- *
- * Each canvas answers for one promise of the material (`what`), and that's also the caption on
- * the bench. A canvas can't be added to only one bench: platform parity would go back to being
- * a matter of impression.
- */
-
-/**
- * BENCH SHAPES — shared too. Element size feeds into the optics through sizeGain: a 120 circle
- * and a 150 circle are glass of different thickness, and screenshots from two benches on
- * different shapes are as incomparable as on different canvases. The values match the ones the
- * reference comparisons were shot on.
- */
-declare const REFERENCE_SHAPES: {
-    circle: VireGlassGeometry;
-    capsule: VireGlassGeometry;
-    tile: VireGlassGeometry;
-};
-type VireGlassRefShapeName = keyof typeof REFERENCE_SHAPES;
-/** A stripe's layer. Lightness is 0..1, sizes are dp: gray, not color (there's nothing to
- *  measure color with). */
-type VireGlassRefLayer = {
-    readonly kind: 'flat';
-    readonly level: number;
-}
-/** Vertical stripes: wider than the bevel, so the body absorbs them rather than the rim. */
- | {
-    readonly kind: 'stripes';
-    readonly level: number;
-    readonly other: number;
-    readonly periodDp: number;
-    readonly widthDp: number;
-}
-/** A pseudo-random checkerboard — a "cover": structure that fights the ink drawn over the glass. */
- | {
-    readonly kind: 'checker';
-    readonly level: number;
-    readonly amp: number;
-    readonly cellDp: number;
-}
-/** Left and right halves at different lightness. */
- | {
-    readonly kind: 'step';
-    readonly left: number;
-    readonly right: number;
-}
-/** A dark bar across the middle of the stripe — measures bulging at the rim against it. */
- | {
-    readonly kind: 'bar';
-    readonly level: number;
-    readonly barLevel: number;
-    readonly thicknessDp: number;
-}
-/** A fine grid: any lens distortion shows up on a straight line right away. */
- | {
-    readonly kind: 'grid';
-    readonly level: number;
-    readonly lineLevel: number;
-    readonly stepDp: number;
-}
-/** A stepped gradient. Steps, not a smooth fill: the native views can't draw a gradient without
- *  an image. */
- | {
-    readonly kind: 'gradient';
-    readonly from: number;
-    readonly to: number;
-    readonly steps: number;
-};
-type VireGlassRefBand = {
-    /** Stripe thickness in dp. The sum over a canvas is `REFERENCE_SCENE_HEIGHT`. */
-    readonly heightDp: number;
-    readonly layer: VireGlassRefLayer;
-};
-/**
- * Canvas size IN DP, one for all. Height is kept within the mobile lab's zone (0.42 of the
- * screen height), width within the narrowest phone (360 dp) with room to spare for the
- * surrounding field.
- *
- * Width matters NO LESS than height. The pattern is measured from the edge of the canvas, so on
- * a canvas spanning the full width of the stage, the phase of the pattern under the element
- * depended on screen width: 24 dp-period stripes landed under the center differently on a 406 dp
- * phone versus a fifteen-hundred-pixel canvas, and the checkerboard put an entirely different
- * cell arrangement under the element. A fixed-size panel removes this whole class of discrepancy
- * at once.
- */
-declare const REFERENCE_SCENE_WIDTH = 336;
-declare const REFERENCE_SCENE_HEIGHT = 252;
-/** The field around the canvas. Deliberately off the stripe levels and not gray: it shows where
- *  the reference area ends, so its border can't be mistaken for a stripe in a screenshot. */
-declare const REFERENCE_SURROUND = "#3c1f4a";
-/**
- * Where the element sits on the canvas — dp from the panel's top-left corner. Position is as much
- * a part of the contract as canvas size and shape: a bench that parks the element its own way
- * shows it over DIFFERENT stripes, and there's nothing left to compare screenshots against.
- *
- * This has drifted before: the web bench centered the element within the VISIBLE area, while the
- * canvas was drawn centered on the full canvas element — with the control panel open, those are
- * two different points.
- */
-declare const REFERENCE_PIECE_AT: {
-    readonly xDp: number;
-    readonly yDp: number;
-};
-type VireGlassRefScene = {
-    readonly name: string;
-    /** What this canvas checks. Also the caption on the bench — otherwise the set turns to mush. */
-    readonly what: string;
-    /** Stripes at a given backdrop lightness: benches call with `level`, the gate sweeps the whole range. */
-    readonly bands: (level: number) => readonly VireGlassRefBand[];
-    /** Default lightness. Canvases that don't need it simply ignore it. */
-    readonly level: number;
-    /**
-     * Whether the canvas is fit for NUMERIC platform comparison. A lightness profile needs a
-     * backdrop that's uniform along the row; on a periodic grid of pixel-wide lines, the average
-     * is determined by how the platform rasterizes that line, not by the material. Such a canvas
-     * stays in the set — distortion of a straight line is visible to the eye at a glance — but it's
-     * excluded from the comparison table.
-     */
-    readonly measurable?: false;
-};
-declare const REFERENCE_SCENES: readonly VireGlassRefScene[];
-type VireGlassRefSceneName = (typeof REFERENCE_SCENES)[number]['name'];
-declare const referenceScene: (name: string) => VireGlassRefScene;
-/** Lightness to hex gray. One conversion for both platforms — otherwise they'd drift apart. */
-declare const refGray: (level: number) => string;
-/**
- * Checkerboard cells as POSITIONS, not as drawing: the canvas loops over them, the native views
- * lay them out as a list, and both platforms get the exact same arrangement. The generator is
- * its own and deliberately simple — `Math.random` would give two platforms different canvases.
- */
-declare const refCheckerCells: (layer: Extract<VireGlassRefLayer, {
-    kind: "checker";
-}>, widthDp: number, heightDp: number) => readonly {
-    readonly xDp: number;
-    readonly yDp: number;
-    readonly level: number;
-}[];
-/** Gradient steps — also positions: the same list for the canvas and for the native views. */
-declare const refGradientSteps: (layer: Extract<VireGlassRefLayer, {
-    kind: "gradient";
-}>) => readonly number[];
-
-/** Smooth union with a second shape — bench morphing experiment only. */
-type VireGlassMorph = {
-    offsetX: number;
-    offsetY: number;
-    width: number;
-    height: number;
-    cornerRadius: number;
-    /** Seam smoothing radius in dp; 0 turns the second shape off. */
-    smoothing: number;
-};
-/** Surface response to a finger: the field around the touch point deforms, not the shape's
- *  bounding box (`vgTouchWarp` in `sdf.ts`). Lengths in dp; `radius` = 0 turns the response off
- *  entirely. */
-type VireGlassTouch = {
-    x: number;
-    y: number;
-    pullX: number;
-    pullY: number;
-    press: number;
-    radius: number;
-    waveAmp: number;
-    wavePhase: number;
-};
-/** Tinted glass for the primary action (M 16:08). Color is RGB 0…1. */
-type VireGlassAccent = {
-    color: readonly [number, number, number];
-    amount?: number;
-};
-/** Default tint fraction: the color reads, but content beneath it is still visible. */
-declare const ACCENT_AMOUNT = 0.8;
-/** Magnification at the flat center. Kept separate from the uniform channel: it's also used by
- *  the fallback below Android 13, where there's no RuntimeShader and only an affine magnifier is
- *  left. */
-declare const lensMagnify: (o: VireGlassOptics) => number;
-/** Props for the native view. Besides the uniform channel, only what the view uses itself lives
- *  here: the shader source and the visible glass's size (the probe rectangle is taken from it). */
-declare function toLensProps(optics: VireGlassOptics, geometry: VireGlassGeometry, density: number, options?: {
-    debug?: VireGlassDebugMode;
-    morph?: VireGlassMorph;
-    /** Third shape of the fused body; a zero size turns it off. */
-    morph2?: VireGlassMorph;
-    groupProbe?: number[];
-    touch?: VireGlassTouch;
-    /** Progress fraction, 0…1: to the left of the boundary the element is active. `undefined` means no progress. */
-    progress?: number;
-    /** Key light direction in screen space; defaults to the light at rest. */
-    light?: readonly [number, number];
-    /** 0…1: the lens builds up as the element appears — instead of a plain fade. */
-    appear?: number;
-    /** Tint for the primary action: the glass color and the fraction it lays over the content. */
-    accent?: VireGlassAccent;
-}): {
-    uniformNames: string[];
-    uniformSizes: number[];
-    uniformValues: number[];
-    shaderSource: string;
-    glassWidth: number;
-    glassHeight: number;
-};
-/** Static part of the surface uniforms. Dynamics (gesture, press, light) get mixed in inside the
- *  component's worklet — the adapter must stay an ordinary function. */
-declare function toSurfaceUniforms(optics: VireGlassOptics, geometry: VireGlassGeometry, options?: {
-    debug?: VireGlassDebugMode;
-    morph?: VireGlassMorph;
-    /** Third shape of the fused body; a zero size turns it off. */
-    morph2?: VireGlassMorph;
-    dragLimit?: number;
-    shadow?: number;
-    /** Average ambient color around the element: light from it bleeds into the shadow (reference 219 @8:22). */
-    ambient?: readonly [number, number, number];
-    /** The lens draws the glass body — the surface is left with the highlight, shadow and icon. */
-    bodyInLens?: boolean;
-    touch?: VireGlassTouch;
-    /** Progress fraction, 0…1: to the left of the boundary the element is active. `undefined` means no progress. */
-    progress?: number;
-    /** 0…1: the element is appearing — shadow and ink build up together with the lens. */
-    appear?: number;
-    /** 0 — the element sinks in under the finger, 1 — it rises into glass (reference §5). */
-    lift?: number;
-}): {
-    u_center: number[];
-    u_halfSize: number[];
-    u_corner: number;
-    u_bevel: number;
-    u_thickness: number;
-    u_morphOffset: number[];
-    u_morphHalf: number[];
-    u_morphCorner: number;
-    u_morphK: number;
-    u_morph2Offset: number[];
-    u_morph2Half: number[];
-    u_morph2Corner: number;
-    u_edgeDensity: number;
-    u_dispersion: number;
-    u_refraction: number;
-    u_tint: number[];
-    u_shadow: number;
-    u_ambient: readonly [number, number, number];
-    u_shadowReach: number;
-    u_touch: number[];
-    u_pull: number[];
-    u_touchPress: number;
-    u_touchRadius: number;
-    u_wave: number[];
-    u_presence: number;
-    u_progress: number;
-    u_appear: number;
-    u_lift: number;
-    u_debug: number;
-};
-/**
- * Surface fields that are LENGTHS: the adapter's contract is specified in dp, and on the web each
- * one of them has to be multiplied by screen density. The list lives here rather than in the
- * renderer, where it used to be a dozen and a half manual multiplications in a row: a missed
- * field there was only caught by eye, and the miss isn't visible everywhere — at density 1,
- * multiplying is indistinguishable from not doing it.
- */
-type SurfaceUniforms = ReturnType<typeof toSurfaceUniforms>;
-declare const SURFACE_LENGTH_UNIFORMS: readonly ["u_halfSize", "u_corner", "u_bevel", "u_morphOffset", "u_morphHalf", "u_morphCorner", "u_morphK", "u_morph2Offset", "u_morph2Half", "u_morph2Corner", "u_shadowReach", "u_touch", "u_pull", "u_touchRadius"];
-/**
- * Surface uniforms in device pixels. Android draws in dp and calls the adapter as-is; the web
- * needs this conversion. `u_center` isn't part of it: the renderer knows the element's center on
- * its own.
- */
-declare function toDeviceSurfaceUniforms(raw: SurfaceUniforms, density: number): SurfaceUniforms;
-/** Key light direction in screen coordinates, for when the orientation response is off. */
-declare const REST_LIGHT: readonly [number, number];
-/** Uniforms the component mixes in inside the worklet (press, active, light direction) and via
- *  the icon layer. Listed here so a test can check the shader contract's completeness without
- *  importing the component itself (it pulls in Skia and doesn't come up in a node environment). */
-declare const DYNAMIC_UNIFORMS: readonly ["u_press", "u_active"];
-declare const ICON_UNIFORMS: readonly ["u_iconOn", "u_iconScale", "u_inkIdle", "u_inkActive"];
-/** App-colored overlay layer on the glass. The `u_overlay` sampler shares its contract with the
- *  ink mask and is sampled at the SAME coordinate — otherwise deformation would carry them apart. */
-declare const OVERLAY_UNIFORMS: readonly ["u_overlayOn"];
-declare function morphBetween(a: VireGlassGeometry, b: VireGlassGeometry, offsetX: number, offsetY: number, t: number): VireGlassMorph | undefined;
-
-export { ACCENT_AMOUNT as A, refCheckerCells as B, refGradientSteps as C, DYNAMIC_UNIFORMS as D, refGray as E, referenceScene as F, rimDp as G, roundedRectGeometry as H, ICON_UNIFORMS as I, shadowOpacity as J, shadowOpacityFrom as K, shadowReachDp as L, MAX_BEVEL_FRACTION as M, sizeGain as N, OVERLAY_UNIFORMS as O, surfacePadDp as P, thicknessDp as Q, REFERENCE_PIECE_AT as R, SURFACE_LENGTH_UNIFORMS as S, toDeviceSurfaceUniforms as T, toLensProps as U, type VireGlassAccent as V, toSurfaceUniforms as W, MAX_STRETCH as a, REFERENCE_SCENES as b, REFERENCE_SCENE_HEIGHT as c, REFERENCE_SCENE_WIDTH as d, REFERENCE_SHAPES as e, REFERENCE_SURROUND as f, REST_LIGHT as g, RIM_FRACTION as h, type SurfaceUniforms as i, type VireGlassGeometry as j, type VireGlassMorph as k, type VireGlassRefBand as l, type VireGlassRefLayer as m, type VireGlassRefScene as n, type VireGlassRefSceneName as o, type VireGlassRefShapeName as p, type VireGlassTouch as q, bevelDp as r, bevelFraction as s, capsuleGeometry as t, circleGeometry as u, halfMinDp as v, lensMagnify as w, lensPadDp as x, morphBetween as y, morphReachDp as z };