@cruxgarden/plasma-ui 0.2.3 → 0.3.0

package/dist/renderer.d.ts

@@ -21,6 +21,16 @@ export interface RendererSettings {
     highlight: number;
     /** Thin edge line strength. */
     edgeLine: number;
+    /** Slow iridescent sheen across the body of each surface. 0 = none. */
+    shimmer: number;
+    /** Colored bloom the plasma casts onto the background around it. 0 = none. */
+    glow: number;
+    /** How much the material tints what is seen through it. 0 = clear as water. */
+    wash: number;
+    /** Film grain over the background. 0 = none. */
+    grain: number;
+    /** Blur applied to the background only, in CSS px (0-40). Costs 8 extra blur passes when above 0. */
+    backgroundBlur: number;
     /** 0 = watery and bouncy, 1 = thick and slow. */
     viscosity: number;
     /** How far the surface trails behind moving panels. 0 = no trailing. */
@@ -55,6 +65,8 @@ export interface ShapeOptions {
     elevation?: number | null;
     /** When false, this surface never blends, bridges, or joins with others. Default true. */
     fuse?: boolean;
+    /** Snap only against surfaces carrying the same group. null groups with the other ungrouped surfaces. */
+    group?: string | null;
 }
 /** Handle returned by `register`, used by <Plasma>. */
 export interface JoinedSides {
@@ -94,13 +106,24 @@ export declare class PlasmaRenderer {
     private bgColor;
     private srcEl;
     private floatOK;
+    /** True between webglcontextlost and webglcontextrestored: draw nothing. */
+    private lost;
+    private warnedOverflow;
+    /**
+     * Set by destroy(). The canvas and its context outlive this renderer, so an
+     * async callback that lands afterwards would happily allocate on a context
+     * nothing can free it from.
+     */
+    private destroyed;
+    private resizeSettle;
+    /** Everything initGL() created, so destroy() can free it by hand. */
+    private owned;
     private recs;
     private nextId;
     private raf;
     private last;
     private time;
     private dpr;
-    private resizeQueued;
     /** Coarse pointer = touch. Only there does a fling run on the compositor with rAF deferred. */
     private coarse;
     private frozen;
@@ -141,13 +164,37 @@ export declare class PlasmaRenderer {
     private loadBackground;
     configure(s: RendererSettings, immediate?: boolean): void;
     register(el: HTMLElement, o: ShapeOptions, onJoin?: (j: boolean) => void, onSides?: (sides: JoinedSides) => void): ShapeHandle;
-    /** Layout boxes of all shapes (lean removed; animating draggables report their destination). */
-    layoutBoxes(excludeId?: number, fusingOnly?: boolean): Box[];
+    /**
+     * Layout boxes of all shapes (lean removed; animating draggables report
+     * their destination). Pass `group` to see only the surfaces in that group;
+     * omit it - as any caller written before groups existed does - to see them all.
+     */
+    layoutBoxes(excludeId?: number, fusingOnly?: boolean, group?: string | null): Box[];
     private layoutBoxOf;
     /** Send a pulse through the material from a viewport point. */
     pulse(x: number, y: number, strength?: number): void;
     /** Raise the material's energy (brightens contours and color); it decays on its own. */
     bump(e: number): void;
+    /** Rebuild the shaders and uniform arrays for a new surface budget. */
+    private setMax;
+    private allocUniformArrays;
+    /** Delete every GL object this renderer created, leaving the canvas usable. */
+    private releaseGL;
+    /**
+     * Every GL object this renderer owns. A lost context invalidates all of
+     * them, so creation lives here rather than in the constructor: the restore
+     * handler runs exactly the same path.
+     */
+    private initGL;
+    /**
+     * A drag-resize reallocates eight render targets per distinct size, and the
+     * driver can drop the context under that. Without these two handlers the
+     * field simply stopped: the frame loop kept running against a dead context
+     * and nothing ever brought it back. preventDefault is what asks the browser
+     * to attempt a restore at all.
+     */
+    private onContextLost;
+    private onContextRestored;
     destroy(): void;
     /**
      * A hidden tab draws nothing anyone can see. Browsers throttle rAF there

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "@cruxgarden/plasma-ui",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Liquid panels for React, rendered in WebGL on canvas: every panel is one shared plasma - they fuse on contact, refract, and snap to a grid.",
   "main": "dist/index.js",
   "scripts": {
     "build": "esbuild src/index.ts --bundle --format=esm --jsx=automatic --target=es2020 --external:react --external:react-dom --outfile=dist/index.js && tsc",
     "build:site": "node site/build.mjs",
     "typecheck": "tsc --noEmit",
+    "typecheck:app": "tsc -p tsconfig.app.json",
+    "typecheck:react19": "npm i --no-save --no-audit --no-fund @types/react@19 @types/react-dom@19 && tsc -p tsconfig.app.json",
+    "format:check": "prettier --check site examples scripts",
     "test": "node --test tests/*.test.mjs",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "prepublishOnly": "npm run verify",
     "format": "prettier --write .",
-    "verify": "npm run typecheck && npm test && npm run build",
+    "check:docs": "node scripts/check-docs.mjs",
+    "verify": "npm run typecheck && npm run typecheck:app && npm run format:check && npm test && npm run build && npm run check:docs",
     "publish:patch": "npm version patch && npm publish && git push && git push --tags",
     "publish:minor": "npm version minor && npm publish && git push && git push --tags",
     "publish:major": "npm version major && npm publish && git push && git push --tags",