@liquid-glass-forge/cpu 0.1.0-rc.1 → 0.1.0-rc.2

package/README.md

@@ -1,8 +1,23 @@
 # @liquid-glass-forge/cpu
 
-Experimental preview. API and device/performance qualification remain open; iPad is unqualified.
+Bounded JavaScript glass rendering with optional worker execution.
 
-Experimental preview JavaScript CPU optics, version `0.1.0-rc.1`.
+[![A live glass lens bends the lettering beneath it](https://raw.githubusercontent.com/namipsg/liquid-glass-forge/main/docs/assets/glass-playground.gif)](https://namipsg.github.io/liquid-glass-forge/#playground)
+
+[Live showcase](https://namipsg.github.io/liquid-glass-forge/#playground) · [Examples](https://namipsg.github.io/liquid-glass-forge/examples.html) · [Documentation](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/PHASE-5.md) · [Support](https://namipsg.github.io/liquid-glass-forge/support.html) · [Install by framework](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/QUICKSTART.md)
+
+## Install
+
+```sh
+npm install @liquid-glass-forge/cpu@0.1.0-rc.2
+```
+
+Keep the Forge packages at matching versions. This is an experimental preview.
+The [support guide](https://namipsg.github.io/liquid-glass-forge/support.html) describes browser and device qualification.
+
+## Usage
+
+Experimental preview JavaScript CPU optics, version `0.1.0-rc.2`.
 Uses explicit core RGBA8 sources. Imports do not acquire browser resources.
 `prepareCpuSource` snapshots pixels into private linear premultiplied storage;
 `renderCpu` implements `rounded-refraction-v1`, optionally extending it with

package/dist/kernel.d.ts

@@ -1,7 +1,8 @@
 import type { PixelSource, SurfaceInput } from '@liquid-glass-forge/core';
 export declare const CPU_MATERIAL_MODEL: 'rounded-material-v1';
+export declare const CPU_LENS_MODEL: 'refractive-lens-v2';
 export interface CpuEffects {
-    readonly model: typeof CPU_MATERIAL_MODEL;
+    readonly model: typeof CPU_MATERIAL_MODEL | typeof CPU_LENS_MODEL;
     readonly blurRadius?: number;
     readonly dispersion?: number;
     readonly tint?: readonly [number, number, number, number];

package/dist/kernel.js

@@ -1,5 +1,6 @@
 import { ContractError, MAX_PIXELS, decodeSrgb, encodeSrgb, validateSource } from '@liquid-glass-forge/core';
 export const CPU_MATERIAL_MODEL = 'rounded-material-v1';
+export const CPU_LENS_MODEL = 'refractive-lens-v2';
 const storage = new WeakMap();
 const ENCODING_STEPS = 4096;
 export const CPU_LOOKUP_BYTES = 12296;
@@ -223,7 +224,7 @@ function surfaceOptions(input, source) {
 function effectOptions(input) {
     if (input !== undefined) {
         object(input, ['model', 'blurRadius', 'dispersion', 'tint', 'rim', 'specular', 'light'], 'effects');
-        if (input.model !== CPU_MATERIAL_MODEL)
+        if (input.model !== CPU_MATERIAL_MODEL && input.model !== CPU_LENS_MODEL)
             throw new ContractError('Unsupported CPU material model');
     }
     const blurRadius = input?.blurRadius === undefined ? 0 : input.blurRadius, dispersion = input?.dispersion === undefined ? 0 : input.dispersion;
@@ -248,7 +249,7 @@ function effectOptions(input) {
     if (scale === 0)
         throw new ContractError('Light direction must be nonzero');
     const lx = light[0] / scale, ly = light[1] / scale, length = Math.hypot(lx, ly);
-    return { blurRadius, dispersion, tint: [decodeSrgb(tint[0]), decodeSrgb(tint[1]), decodeSrgb(tint[2]), tint[3]], rim, specular, light: [lx / length, ly / length] };
+    return { lens: input?.model === CPU_LENS_MODEL, blurRadius, dispersion, tint: [decodeSrgb(tint[0]), decodeSrgb(tint[1]), decodeSrgb(tint[2]), tint[3]], rim, specular, light: [lx / length, ly / length] };
 }
 /** Validate and freeze a data-only snapshot before asynchronous execution. */
 export function snapshotCpuEffects(input) {
@@ -378,6 +379,11 @@ function renderClassifiedOpaque(prepared, surface, data, geo, encoding, output)
 export function renderCpu(prepared, input, effects, output) {
     const s = live(prepared), surface = surfaceOptions(input, prepared), e = effectOptions(effects);
     const { width, height, radius, bevel, strength, sourceRect: rect } = surface;
+    // A bevel wider than the corner's curvature reaches the SDF medial axis,
+    // where the nearest edge (and its normal) changes discontinuously. Keep the
+    // v2 ray profile outside that axis; a sharp corner has only subpixel bevel.
+    // The versioned v1 material retains its original geometry.
+    const opticalBevel = e.lens ? Math.min(bevel, Math.max(radius, .5)) : bevel;
     if (output === undefined)
         output = new Uint8ClampedArray(width * height * 4);
     try {
@@ -390,7 +396,7 @@ export function renderCpu(prepared, input, effects, output) {
         throw new ContractError('Invalid CPU output storage');
     const data = blurred(prepared, s, e.blurRadius), scaleX = rect.width / width, scaleY = rect.height / height;
     const encoding = getColourTables();
-    const baseline = e.blurRadius === 0 && e.dispersion === 0 && e.tint[3] === 0 && e.rim === 0 && e.specular === 0;
+    const baseline = !e.lens && e.blurRadius === 0 && e.dispersion === 0 && e.tint[3] === 0 && e.rim === 0 && e.specular === 0;
     const preferResampling = baseline && s.opaque && scaleX === 2 && scaleY === 2 && Number.isInteger(rect.x) && Number.isInteger(rect.y);
     const geo = baseline ? geometryCache(s, width, height, radius, bevel, preferResampling) : undefined;
     const sourceRgb = geo?.sourceResampling ? resampledSourceRgb(prepared, data, surface, geo, encoding) : undefined;
@@ -429,7 +435,7 @@ export function renderCpu(prepared, input, effects, output) {
                 }
             }
             else {
-                const g = geometry(width, height, radius, bevel, x, y);
+                const g = geometry(width, height, radius, opticalBevel, x, y);
                 coverage = g.coverage;
                 normalX = g.normalX;
                 normalY = g.normalY;
@@ -440,7 +446,15 @@ export function renderCpu(prepared, input, effects, output) {
                 continue;
             }
             const baseX = rect.x + (x + .5) * scaleX - .5, baseY = rect.y + (y + .5) * scaleY - .5;
-            const dx = normalX * strength * weight * scaleX, dy = normalY * strength * weight * scaleY;
+            // Opt-in v2: trace an air-to-glass ray through an elliptical bevel
+            // (eta = 1 / 1.5). Backdrop sampling bends inward; v1 remains unchanged.
+            let displacement = weight;
+            if (e.lens && weight > 0) {
+                const u = Math.sqrt(weight), nz = Math.sqrt(Math.max(0, 1 - u * u)), eta = 2 / 3;
+                const bend = Math.sqrt(1 - eta * eta * u * u) - eta * nz;
+                displacement = -u * bend / (eta + bend * nz);
+            }
+            const dx = normalX * strength * displacement * scaleX, dy = normalY * strength * displacement * scaleY;
             if (sourceRgb && dx === 0 && dy === 0) {
                 output[index + 3] = Math.round(coverage * 255);
                 const at = (y * width + x) * 3;

package/dist/worker-kernel.js

@@ -1,5 +1,6 @@
 import { ContractError, MAX_PIXELS, decodeSrgb, encodeSrgb, validateSource } from './worker-core.js';
 export const CPU_MATERIAL_MODEL = 'rounded-material-v1';
+export const CPU_LENS_MODEL = 'refractive-lens-v2';
 const storage = new WeakMap();
 const ENCODING_STEPS = 4096;
 export const CPU_LOOKUP_BYTES = 12296;
@@ -223,7 +224,7 @@ function surfaceOptions(input, source) {
 function effectOptions(input) {
     if (input !== undefined) {
         object(input, ['model', 'blurRadius', 'dispersion', 'tint', 'rim', 'specular', 'light'], 'effects');
-        if (input.model !== CPU_MATERIAL_MODEL)
+        if (input.model !== CPU_MATERIAL_MODEL && input.model !== CPU_LENS_MODEL)
             throw new ContractError('Unsupported CPU material model');
     }
     const blurRadius = input?.blurRadius === undefined ? 0 : input.blurRadius, dispersion = input?.dispersion === undefined ? 0 : input.dispersion;
@@ -248,7 +249,7 @@ function effectOptions(input) {
     if (scale === 0)
         throw new ContractError('Light direction must be nonzero');
     const lx = light[0] / scale, ly = light[1] / scale, length = Math.hypot(lx, ly);
-    return { blurRadius, dispersion, tint: [decodeSrgb(tint[0]), decodeSrgb(tint[1]), decodeSrgb(tint[2]), tint[3]], rim, specular, light: [lx / length, ly / length] };
+    return { lens: input?.model === CPU_LENS_MODEL, blurRadius, dispersion, tint: [decodeSrgb(tint[0]), decodeSrgb(tint[1]), decodeSrgb(tint[2]), tint[3]], rim, specular, light: [lx / length, ly / length] };
 }
 /** Validate and freeze a data-only snapshot before asynchronous execution. */
 export function snapshotCpuEffects(input) {
@@ -378,6 +379,11 @@ function renderClassifiedOpaque(prepared, surface, data, geo, encoding, output)
 export function renderCpu(prepared, input, effects, output) {
     const s = live(prepared), surface = surfaceOptions(input, prepared), e = effectOptions(effects);
     const { width, height, radius, bevel, strength, sourceRect: rect } = surface;
+    // A bevel wider than the corner's curvature reaches the SDF medial axis,
+    // where the nearest edge (and its normal) changes discontinuously. Keep the
+    // v2 ray profile outside that axis; a sharp corner has only subpixel bevel.
+    // The versioned v1 material retains its original geometry.
+    const opticalBevel = e.lens ? Math.min(bevel, Math.max(radius, .5)) : bevel;
     if (output === undefined)
         output = new Uint8ClampedArray(width * height * 4);
     try {
@@ -390,7 +396,7 @@ export function renderCpu(prepared, input, effects, output) {
         throw new ContractError('Invalid CPU output storage');
     const data = blurred(prepared, s, e.blurRadius), scaleX = rect.width / width, scaleY = rect.height / height;
     const encoding = getColourTables();
-    const baseline = e.blurRadius === 0 && e.dispersion === 0 && e.tint[3] === 0 && e.rim === 0 && e.specular === 0;
+    const baseline = !e.lens && e.blurRadius === 0 && e.dispersion === 0 && e.tint[3] === 0 && e.rim === 0 && e.specular === 0;
     const preferResampling = baseline && s.opaque && scaleX === 2 && scaleY === 2 && Number.isInteger(rect.x) && Number.isInteger(rect.y);
     const geo = baseline ? geometryCache(s, width, height, radius, bevel, preferResampling) : undefined;
     const sourceRgb = geo?.sourceResampling ? resampledSourceRgb(prepared, data, surface, geo, encoding) : undefined;
@@ -429,7 +435,7 @@ export function renderCpu(prepared, input, effects, output) {
                 }
             }
             else {
-                const g = geometry(width, height, radius, bevel, x, y);
+                const g = geometry(width, height, radius, opticalBevel, x, y);
                 coverage = g.coverage;
                 normalX = g.normalX;
                 normalY = g.normalY;
@@ -440,7 +446,15 @@ export function renderCpu(prepared, input, effects, output) {
                 continue;
             }
             const baseX = rect.x + (x + .5) * scaleX - .5, baseY = rect.y + (y + .5) * scaleY - .5;
-            const dx = normalX * strength * weight * scaleX, dy = normalY * strength * weight * scaleY;
+            // Opt-in v2: trace an air-to-glass ray through an elliptical bevel
+            // (eta = 1 / 1.5). Backdrop sampling bends inward; v1 remains unchanged.
+            let displacement = weight;
+            if (e.lens && weight > 0) {
+                const u = Math.sqrt(weight), nz = Math.sqrt(Math.max(0, 1 - u * u)), eta = 2 / 3;
+                const bend = Math.sqrt(1 - eta * eta * u * u) - eta * nz;
+                displacement = -u * bend / (eta + bend * nz);
+            }
+            const dx = normalX * strength * displacement * scaleX, dy = normalY * strength * displacement * scaleY;
             if (sourceRgb && dx === 0 && dy === 0) {
                 output[index + 3] = Math.round(coverage * 255);
                 const at = (y * width + x) * 3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquid-glass-forge/cpu",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.2",
   "description": "Experimental JavaScript CPU optics for explicit Liquid Glass Forge pixel sources",
   "private": false,
   "type": "module",
@@ -26,8 +26,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@liquid-glass-forge/core": "0.1.0-rc.1"
+    "@liquid-glass-forge/core": "0.1.0-rc.2"
   },
+  "homepage": "https://namipsg.github.io/liquid-glass-forge/#playground",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/namipsg/liquid-glass-forge.git",