pixelagent 0.1.24 → 0.1.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"glassDisplacementWebGL-mRLN1KMg.js","sources":["../src/glass/glassDisplacementWebGL.ts"],"sourcesContent":["/**\n * WebGL2 fragment-shader port of the SVG `feDisplacementMap` rim-pull effect.\n *\n * Reuses the displacement PNG produced by {@link generateLiquidGlassMap} — the\n * R/G channels encode the same offset vectors the Chromium `feDisplacementMap`\n * path samples. Running the same encoded data through this shader yields\n * pixel-equivalent rim refraction on Safari and Firefox, which silently drop\n * `backdrop-filter: url(#…)` chains and so produce no refraction on the\n * Chromium fast path.\n *\n * Input contract (matches SVG `feDisplacementMap` semantics):\n * offset_px = (texture(displacement, uv).rg - 0.5) * scale\n * output_px = texture(background, uv + offset_px / resolution)\n *\n * Caller owns DOM placement and lifetime of the returned canvas.\n */\n\nimport type { DisplacementMap } from './displacementMap';\n\nconst VERT_SHADER = `#version 300 es\nin vec2 a_position;\nout vec2 v_uv;\nvoid main() {\n // a_position is in clip space [-1, 1]; v_uv maps to [0, 1] for texture sampling.\n v_uv = a_position * 0.5 + 0.5;\n gl_Position = vec4(a_position, 0.0, 1.0);\n}`;\n\nconst FRAG_SHADER = `#version 300 es\nprecision highp float;\nin vec2 v_uv;\nuniform sampler2D u_background;\nuniform sampler2D u_displacement;\nuniform vec2 u_resolution;\nuniform float u_scale;\nout vec4 fragColor;\nvoid main() {\n // R/G channel encoding (matches displacementMap.ts):\n // stored = raw / maxScale + 0.5 (clamped to [0,1])\n // → decoded in [-0.5, +0.5], scaled to pixels via u_scale.\n vec2 disp = texture(u_displacement, v_uv).rg - 0.5;\n vec2 offsetPx = disp * u_scale;\n vec2 sampleUv = v_uv + offsetPx / u_resolution;\n fragColor = texture(u_background, sampleUv);\n}`;\n\nexport type BackgroundSource = TexImageSource;\n\nexport interface DisplacementRenderInputs {\n /** Captured pixels behind the glass surface — feeds the shader's u_background. */\n background: BackgroundSource;\n /** The output of {@link generateLiquidGlassMap}. */\n displacementMap: DisplacementMap;\n /** Output canvas dimensions in CSS pixels; matches the glass surface size. */\n width: number;\n height: number;\n /** Optional: reuse an existing canvas (avoids GC churn under ResizeObserver). */\n canvas?: HTMLCanvasElement;\n}\n\n/** Programs/textures we keep around between renders to avoid recompiling\n * shaders on every scroll/resize tick. Keyed by canvas element identity. */\ninterface GlState {\n gl: WebGL2RenderingContext;\n program: WebGLProgram;\n vao: WebGLVertexArrayObject;\n backgroundTex: WebGLTexture;\n displacementTex: WebGLTexture;\n uResolution: WebGLUniformLocation;\n uScale: WebGLUniformLocation;\n displacementHref: string | null;\n displacementImage: HTMLImageElement | null;\n}\n\nconst stateByCanvas: WeakMap<HTMLCanvasElement, GlState> = new WeakMap();\n\nfunction compileShader(\n gl: WebGL2RenderingContext,\n type: GLenum,\n source: string\n): WebGLShader {\n const shader = gl.createShader(type);\n if (!shader) throw new Error('WebGL2: createShader returned null');\n gl.shaderSource(shader, source);\n gl.compileShader(shader);\n if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {\n const log = gl.getShaderInfoLog(shader) ?? 'unknown';\n gl.deleteShader(shader);\n throw new Error(`WebGL2 shader compile error: ${log}`);\n }\n return shader;\n}\n\nfunction linkProgram(gl: WebGL2RenderingContext): WebGLProgram {\n const program = gl.createProgram();\n if (!program) throw new Error('WebGL2: createProgram returned null');\n const vs = compileShader(gl, gl.VERTEX_SHADER, VERT_SHADER);\n const fs = compileShader(gl, gl.FRAGMENT_SHADER, FRAG_SHADER);\n gl.attachShader(program, vs);\n gl.attachShader(program, fs);\n gl.linkProgram(program);\n if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {\n const log = gl.getProgramInfoLog(program) ?? 'unknown';\n gl.deleteProgram(program);\n throw new Error(`WebGL2 program link error: ${log}`);\n }\n // Shaders can be detached after link; keeps memory tidy.\n gl.deleteShader(vs);\n gl.deleteShader(fs);\n return program;\n}\n\nfunction initState(canvas: HTMLCanvasElement): GlState | null {\n const gl = canvas.getContext('webgl2', {\n alpha: true,\n premultipliedAlpha: true,\n antialias: false,\n preserveDrawingBuffer: false,\n });\n if (!gl) return null;\n\n const program = linkProgram(gl);\n\n // Full-screen quad — two triangles covering clip space [-1,1]².\n const vao = gl.createVertexArray();\n if (!vao) throw new Error('WebGL2: createVertexArray returned null');\n gl.bindVertexArray(vao);\n const buf = gl.createBuffer();\n gl.bindBuffer(gl.ARRAY_BUFFER, buf);\n gl.bufferData(\n gl.ARRAY_BUFFER,\n new Float32Array([-1, -1, 1, -1, -1, 1, 1, -1, 1, 1, -1, 1]),\n gl.STATIC_DRAW\n );\n const aPos = gl.getAttribLocation(program, 'a_position');\n gl.enableVertexAttribArray(aPos);\n gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, 0, 0);\n gl.bindVertexArray(null);\n\n const mkTex = (unit: number): WebGLTexture => {\n const tex = gl.createTexture();\n if (!tex) throw new Error('WebGL2: createTexture returned null');\n gl.activeTexture(gl.TEXTURE0 + unit);\n gl.bindTexture(gl.TEXTURE_2D, tex);\n gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);\n gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);\n gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);\n gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);\n return tex;\n };\n const backgroundTex = mkTex(0);\n const displacementTex = mkTex(1);\n\n gl.useProgram(program);\n gl.uniform1i(gl.getUniformLocation(program, 'u_background'), 0);\n gl.uniform1i(gl.getUniformLocation(program, 'u_displacement'), 1);\n\n const uResolution = gl.getUniformLocation(program, 'u_resolution');\n const uScale = gl.getUniformLocation(program, 'u_scale');\n if (!uResolution || !uScale) {\n throw new Error('WebGL2: required uniforms not found in linked program');\n }\n\n return {\n gl,\n program,\n vao,\n backgroundTex,\n displacementTex,\n uResolution,\n uScale,\n displacementHref: null,\n displacementImage: null,\n };\n}\n\nfunction loadImage(href: string): Promise<HTMLImageElement> {\n return new Promise((resolve, reject) => {\n const img = new Image();\n img.onload = () => resolve(img);\n img.onerror = () => reject(new Error(`Failed to load displacement image`));\n img.src = href;\n });\n}\n\n/**\n * Render a single displaced frame. Returns the rendered canvas (or null when\n * WebGL2 is unavailable — caller should fall back to a non-refracted look).\n *\n * Synchronous when the displacement PNG for this canvas is already cached;\n * a one-time async hop occurs the first time a new PNG is supplied.\n */\nexport async function renderDisplaced(\n inputs: DisplacementRenderInputs\n): Promise<HTMLCanvasElement | null> {\n const canvas = inputs.canvas ?? document.createElement('canvas');\n // CSS pixel size; the buffer matches so 1 fragment = 1 css px (no DPR scaling\n // here — the caller scales via CSS transform if needed for hi-DPI).\n if (canvas.width !== inputs.width) canvas.width = inputs.width;\n if (canvas.height !== inputs.height) canvas.height = inputs.height;\n\n let state = stateByCanvas.get(canvas);\n if (!state) {\n const next = initState(canvas);\n if (!next) return null;\n state = next;\n stateByCanvas.set(canvas, state);\n }\n const { gl, program, vao, backgroundTex, displacementTex } = state;\n\n // Lazy-load + cache the displacement PNG. The href is a data URL that\n // changes only when the surface resizes, so this almost always hits cache.\n if (state.displacementHref !== inputs.displacementMap.href) {\n state.displacementImage = await loadImage(inputs.displacementMap.href);\n state.displacementHref = inputs.displacementMap.href;\n gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);\n gl.activeTexture(gl.TEXTURE1);\n gl.bindTexture(gl.TEXTURE_2D, displacementTex);\n gl.texImage2D(\n gl.TEXTURE_2D,\n 0,\n gl.RGBA,\n gl.RGBA,\n gl.UNSIGNED_BYTE,\n state.displacementImage\n );\n }\n\n // Background uploads every frame — it changes with scroll/theme/etc.\n gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);\n gl.activeTexture(gl.TEXTURE0);\n gl.bindTexture(gl.TEXTURE_2D, backgroundTex);\n gl.texImage2D(\n gl.TEXTURE_2D,\n 0,\n gl.RGBA,\n gl.RGBA,\n gl.UNSIGNED_BYTE,\n inputs.background\n );\n\n gl.viewport(0, 0, canvas.width, canvas.height);\n gl.useProgram(program);\n gl.uniform2f(state.uResolution, canvas.width, canvas.height);\n gl.uniform1f(state.uScale, inputs.displacementMap.scale);\n gl.bindVertexArray(vao);\n gl.drawArrays(gl.TRIANGLES, 0, 6);\n gl.bindVertexArray(null);\n\n return canvas;\n}\n"],"names":["VERT_SHADER","FRAG_SHADER","stateByCanvas","compileShader","gl","type","source","shader","log","linkProgram","program","vs","fs","initState","canvas","vao","buf","aPos","mkTex","unit","tex","backgroundTex","displacementTex","uResolution","uScale","loadImage","href","resolve","reject","img","renderDisplaced","inputs","state","next"],"mappings":"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"}