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

package/README.md

@@ -1,8 +1,26 @@
-# Liquid Glass Forge DOM sources
+# <img src="https://raw.githubusercontent.com/namipsg/liquid-glass-forge/main/showcase/public/frameworks/vanilla.svg" width="20" height="20" alt=""> @liquid-glass-forge/dom
 
-Experimental preview. API and device/performance qualification remain open; iPad is unqualified.
+Render glass on native HTML controls with explicit media sources and shared scenes.
 
-Experimental preview `0.1.0-rc.1` sources, coordinate mapping and vanilla host/lifecycle.
+[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/HOSTS.md) · [Support](https://namipsg.github.io/liquid-glass-forge/support.html)
+
+## Install in Vanilla JS
+
+```sh
+npm install @liquid-glass-forge/dom@next
+```
+
+The starter uses CSS glass. Keep the Forge packages at matching versions.
+The [live installer](https://namipsg.github.io/liquid-glass-forge/?framework=vanilla#developers)
+shows verified exact versions and has a copy button.
+
+[Open the Vanilla JS starter](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/QUICKSTART.md#vanilla) · [Add WebGL refraction](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/QUICKSTART.md#add-webgl-refraction)
+
+[![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)
+
+## Usage
+
+Experimental preview `0.1.0-rc.2` sources, coordinate mapping and vanilla host/lifecycle.
 Requires exact matching core/CPU package versions. ESM and TypeScript
 declarations are included; imports are SSR-safe and start no timers or network.
 

package/dist/cpu.d.ts

@@ -19,6 +19,8 @@ export interface CpuRendererOptions {
         readonly maxHeight?: number;
         readonly maxUpdatesPerSecond?: number;
         readonly maxSourcePixels?: number;
+        /** Explicit active-interaction policy; balanced/default retains its 30 Hz limit. */
+        readonly cadence?: 'balanced' | 'interactive';
     };
 }
 /** One scene owns this adapter. Initialization owns resources; construction only snapshots data. */
@@ -45,13 +47,16 @@ export declare class CpuRenderer implements GlassRenderer {
         effectiveHeight: number | undefined;
         qualityReduced: boolean;
         reasons: readonly string[];
-        quality: Required<{
+        quality: Required<Omit<{
             readonly maxPixels?: number;
             readonly maxWidth?: number;
             readonly maxHeight?: number;
             readonly maxUpdatesPerSecond?: number;
             readonly maxSourcePixels?: number;
-        }>;
+            /** Explicit active-interaction policy; balanced/default retains its 30 Hz limit. */
+            readonly cadence?: 'balanced' | 'interactive';
+        }, "cadence">>;
+        cadencePolicy?: "interactive";
         timings: (CpuTimings & {
             readonly captureMs: number;
             readonly rateWaitMs: number;

package/dist/cpu.js

@@ -49,6 +49,7 @@ export class CpuRenderer {
     #effects;
     #sourceRect;
     #quality;
+    #cadence;
     #executor;
     #pacer;
     #cleanup;
@@ -75,7 +76,10 @@ export class CpuRenderer {
         this.#effects = snapshotCpuEffects(options.effects);
         this.#sourceRect = typeof options.sourceRect === 'function' || options.sourceRect === undefined ? options.sourceRect : sourceRect(options.sourceRect);
         const quality = options.quality === undefined ? {} : options.quality;
-        object(quality, ['maxPixels', 'maxWidth', 'maxHeight', 'maxUpdatesPerSecond', 'maxSourcePixels'], 'quality');
+        object(quality, ['maxPixels', 'maxWidth', 'maxHeight', 'maxUpdatesPerSecond', 'maxSourcePixels', 'cadence'], 'quality');
+        if (quality.cadence !== undefined && !['balanced', 'interactive'].includes(quality.cadence))
+            throw new CpuError('INVALID_OPTIONS', 'Invalid CPU cadence policy');
+        this.#cadence = quality.cadence ?? 'balanced';
         const q = { maxPixels: quality.maxPixels === undefined ? 57600 : quality.maxPixels,
             maxWidth: quality.maxWidth === undefined ? 320 : quality.maxWidth, maxHeight: quality.maxHeight === undefined ? 180 : quality.maxHeight,
             maxUpdatesPerSecond: quality.maxUpdatesPerSecond === undefined ? 30 : quality.maxUpdatesPerSecond,
@@ -85,7 +89,7 @@ export class CpuRenderer {
             if (!Number.isSafeInteger(q[key]))
                 throw new CpuError('INVALID_OPTIONS', `${key} must be an integer`);
         }
-        finite(q.maxUpdatesPerSecond, 1, 30, 'maxUpdatesPerSecond');
+        finite(q.maxUpdatesPerSecond, 1, this.#cadence === 'interactive' ? 60 : 30, 'maxUpdatesPerSecond');
         this.#quality = Object.freeze(q);
     }
     executorDiagnostics() { return this.#executor.diagnostics; }
@@ -96,7 +100,7 @@ export class CpuRenderer {
             requestedWidth: this.#requested?.width, requestedHeight: this.#requested?.height,
             effectiveWidth: this.#effective?.width, effectiveHeight: this.#effective?.height,
             qualityReduced: this.#reasons.length > 0, reasons: this.#reasons, quality: this.#quality,
-            timings: this.#timings, surface: this.#lastSurface, executor });
+            ...(this.#cadence === 'interactive' ? { cadencePolicy: this.#cadence } : {}), timings: this.#timings, surface: this.#lastSurface, executor });
     }
     initialize(signal) {
         if (this.#disposed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquid-glass-forge/dom",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.2",
   "description": "Experimental explicit sources, coordinates and vanilla host lifecycle for Liquid Glass Forge",
   "private": false,
   "type": "module",
@@ -26,9 +26,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@liquid-glass-forge/core": "0.1.0-rc.1",
-    "@liquid-glass-forge/cpu": "0.1.0-rc.1"
+    "@liquid-glass-forge/core": "0.1.0-rc.2",
+    "@liquid-glass-forge/cpu": "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",