@skenora/runtime 0.1.2

package/dist/systems/sprite-sheet-controller.d.ts

@@ -0,0 +1,52 @@
+/** Runtime-only sprite sheet playback configuration. */
+export interface SpriteSheetConfig {
+    frameCount: number;
+    frameWidth: number;
+    frameHeight: number;
+    sheetWidth?: number;
+    sheetHeight?: number;
+    fps: number;
+    loop: boolean;
+    autoPlay?: boolean;
+}
+export interface SpriteSheetFrame {
+    index: number;
+    column: number;
+    row: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface SpriteSheetSink {
+    applyFrame(frame: Readonly<SpriteSheetFrame>): void;
+}
+export interface SpriteSheetPlaybackState {
+    playing: boolean;
+    frame: number;
+    progress: number;
+    fps: number;
+    loop: boolean;
+}
+export interface AnimationFrameScheduler {
+    now(): number;
+    request(callback: (time: number) => void): number;
+    cancel(handle: number): void;
+}
+/** Renderer-neutral sprite timing and crop calculation. */
+export declare class SpriteSheetController {
+    #private;
+    readonly sink: SpriteSheetSink;
+    readonly scheduler: AnimationFrameScheduler;
+    constructor(sink: SpriteSheetSink, config: SpriteSheetConfig, scheduler?: AnimationFrameScheduler);
+    get state(): SpriteSheetPlaybackState;
+    subscribe(listener: (state: SpriteSheetPlaybackState) => void): () => void;
+    play(): void;
+    pause(): void;
+    stop(): void;
+    goToFrame(frame: number): void;
+    seek(progress: number): void;
+    updateConfig(update: Partial<SpriteSheetConfig>): void;
+    dispose(): void;
+}
+//# sourceMappingURL=sprite-sheet-controller.d.ts.map

package/dist/systems/sprite-sheet-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-sheet-controller.d.ts","sourceRoot":"","sources":["../../src/systems/sprite-sheet-controller.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,IAAI,MAAM,CAAC;IACd,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;IAClD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAQD,2DAA2D;AAC3D,qBAAa,qBAAqB;;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;gBAW1C,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,iBAAiB,EACzB,SAAS,GAAE,uBAA2C;IAUxD,IAAI,KAAK,IAAI,wBAAwB,CAWpC;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,GAAG,MAAM,IAAI;IAO1E,IAAI,IAAI,IAAI;IAaZ,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAUZ,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAW5B,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAWtD,OAAO,IAAI,IAAI;CAkEhB"}

package/dist/systems/sprite-sheet-controller.js

@@ -0,0 +1,187 @@
+const BROWSER_SCHEDULER = {
+    now: () => performance.now(),
+    request: (callback) => requestAnimationFrame(callback),
+    cancel: (handle) => cancelAnimationFrame(handle),
+};
+/** Renderer-neutral sprite timing and crop calculation. */
+export class SpriteSheetController {
+    sink;
+    scheduler;
+    #listeners = new Set();
+    #config;
+    #frame = 0;
+    #playing = false;
+    #handle = null;
+    #lastTime = 0;
+    #accumulated = 0;
+    #disposed = false;
+    constructor(sink, config, scheduler = BROWSER_SCHEDULER) {
+        validateConfig(config);
+        this.sink = sink;
+        this.scheduler = scheduler;
+        this.#config = { ...config };
+        this.#applyFrame();
+        if (config.autoPlay)
+            this.play();
+    }
+    get state() {
+        return {
+            playing: this.#playing,
+            frame: this.#frame,
+            progress: this.#config.frameCount <= 1
+                ? 0
+                : this.#frame / (this.#config.frameCount - 1),
+            fps: this.#config.fps,
+            loop: this.#config.loop,
+        };
+    }
+    subscribe(listener) {
+        this.#assertActive();
+        this.#listeners.add(listener);
+        listener(this.state);
+        return () => this.#listeners.delete(listener);
+    }
+    play() {
+        this.#assertActive();
+        if (this.#playing)
+            return;
+        if (!this.#config.loop && this.#frame >= this.#config.frameCount - 1) {
+            this.#frame = 0;
+            this.#applyFrame();
+        }
+        this.#playing = true;
+        this.#lastTime = this.scheduler.now();
+        this.#handle = this.scheduler.request(this.#tick);
+        this.#emit();
+    }
+    pause() {
+        this.#assertActive();
+        if (!this.#playing)
+            return;
+        this.#playing = false;
+        this.#cancelFrame();
+        this.#emit();
+    }
+    stop() {
+        this.#assertActive();
+        this.#playing = false;
+        this.#cancelFrame();
+        this.#frame = 0;
+        this.#accumulated = 0;
+        this.#applyFrame();
+        this.#emit();
+    }
+    goToFrame(frame) {
+        this.#assertActive();
+        if (!Number.isFinite(frame))
+            throw new Error("Sprite frame must be finite");
+        this.#frame = Math.max(0, Math.min(this.#config.frameCount - 1, Math.floor(frame)));
+        this.#accumulated = 0;
+        this.#applyFrame();
+        this.#emit();
+    }
+    seek(progress) {
+        if (!Number.isFinite(progress)) {
+            throw new Error("Sprite progress must be finite");
+        }
+        this.goToFrame(Math.round(Math.max(0, Math.min(1, progress)) * (this.#config.frameCount - 1)));
+    }
+    updateConfig(update) {
+        this.#assertActive();
+        const config = { ...this.#config, ...update };
+        validateConfig(config);
+        this.#config = config;
+        this.#frame = Math.min(this.#frame, config.frameCount - 1);
+        this.#accumulated = 0;
+        this.#applyFrame();
+        this.#emit();
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#playing = false;
+        this.#cancelFrame();
+        this.#listeners.clear();
+        this.#disposed = true;
+    }
+    #tick = (now) => {
+        if (!this.#playing)
+            return;
+        this.#accumulated += Math.max(0, now - this.#lastTime);
+        this.#lastTime = now;
+        const interval = 1_000 / this.#config.fps;
+        while (this.#accumulated >= interval && this.#playing) {
+            this.#accumulated -= interval;
+            const next = this.#frame + 1;
+            if (next >= this.#config.frameCount) {
+                if (this.#config.loop)
+                    this.#frame = 0;
+                else {
+                    this.#frame = this.#config.frameCount - 1;
+                    this.#playing = false;
+                }
+            }
+            else {
+                this.#frame = next;
+            }
+            this.#applyFrame();
+            this.#emit();
+        }
+        this.#handle = this.#playing ? this.scheduler.request(this.#tick) : null;
+    };
+    #applyFrame() {
+        const columns = this.#config.sheetWidth
+            ? Math.max(1, Math.floor(this.#config.sheetWidth / this.#config.frameWidth))
+            : this.#config.frameCount;
+        const column = this.#frame % columns;
+        const row = Math.floor(this.#frame / columns);
+        this.sink.applyFrame({
+            index: this.#frame,
+            column,
+            row,
+            x: column * this.#config.frameWidth,
+            y: row * this.#config.frameHeight,
+            width: this.#config.frameWidth,
+            height: this.#config.frameHeight,
+        });
+    }
+    #cancelFrame() {
+        if (this.#handle !== null)
+            this.scheduler.cancel(this.#handle);
+        this.#handle = null;
+    }
+    #emit() {
+        const state = this.state;
+        for (const listener of this.#listeners)
+            listener(state);
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("SpriteSheetController has been disposed");
+        }
+    }
+}
+function validateConfig(config) {
+    for (const [name, value] of Object.entries({
+        frameCount: config.frameCount,
+        frameWidth: config.frameWidth,
+        frameHeight: config.frameHeight,
+        fps: config.fps,
+    })) {
+        if (!Number.isFinite(value) || value <= 0) {
+            throw new Error(`Sprite ${name} must be positive`);
+        }
+    }
+    if (!Number.isInteger(config.frameCount)) {
+        throw new Error("Sprite frameCount must be an integer");
+    }
+    if (config.sheetWidth !== undefined &&
+        (!Number.isFinite(config.sheetWidth) || config.sheetWidth <= 0)) {
+        throw new Error("Sprite sheetWidth must be positive");
+    }
+    if (config.sheetHeight !== undefined &&
+        (!Number.isFinite(config.sheetHeight) || config.sheetHeight <= 0)) {
+        throw new Error("Sprite sheetHeight must be positive");
+    }
+}
+//# sourceMappingURL=sprite-sheet-controller.js.map

package/dist/systems/sprite-sheet-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-sheet-controller.js","sourceRoot":"","sources":["../../src/systems/sprite-sheet-controller.ts"],"names":[],"mappings":"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"}

package/dist/systems/surface-effect-plugin.d.ts

@@ -0,0 +1,26 @@
+import { MaterialPluginBase } from "@babylonjs/core/Materials/materialPluginBase";
+import type { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { MaterialDefines } from "@babylonjs/core/Materials/materialDefines";
+import type { UniformBuffer } from "@babylonjs/core/Materials/uniformBuffer";
+import { type MaterialSurfaceEffects } from "@skenora/contracts";
+/** One instance per owned material; no global Babylon plugin registration. */
+export declare class SurfaceEffectPlugin extends MaterialPluginBase {
+    #private;
+    constructor(material: PBRMaterial, effects: MaterialSurfaceEffects);
+    update(effects: MaterialSurfaceEffects): void;
+    capture(): MaterialSurfaceEffects;
+    prepareDefines(defines: MaterialDefines): void;
+    getClassName(): string;
+    getUniforms(): {
+        ubo: {
+            name: string;
+            size: number;
+            type: string;
+        }[];
+        fragment: string;
+    };
+    hardBindForSubMesh(buffer: UniformBuffer): void;
+    getCustomCode(shaderType: string): Record<string, string> | null;
+    dispose(): void;
+}
+//# sourceMappingURL=surface-effect-plugin.d.ts.map

package/dist/systems/surface-effect-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-effect-plugin.d.ts","sourceRoot":"","sources":["../../src/systems/surface-effect-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,8EAA8E;AAC9E,qBAAa,mBAAoB,SAAQ,kBAAkB;;gBAI7C,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB;IAgBlE,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAgB7C,OAAO,IAAI,sBAAsB;IAIxB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAe9C,YAAY,IAAI,MAAM;IAItB,WAAW;;;;;;;;IAuCX,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAiG/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAmFhE,OAAO,IAAI,IAAI;CAGzB"}

package/dist/systems/surface-effect-plugin.js

@@ -0,0 +1,204 @@
+import { MaterialPluginBase } from "@babylonjs/core/Materials/materialPluginBase";
+import { normalizeMaterialEffects, } from "@skenora/contracts";
+/** One instance per owned material; no global Babylon plugin registration. */
+export class SurfaceEffectPlugin extends MaterialPluginBase {
+    #effects;
+    #disposed = false;
+    constructor(material, effects) {
+        // Babylon inspects code hooks from super(); those methods only return static
+        // source and never access subclass state before initialization.
+        super(material, "skenora.surface-effects.v2", 200, {
+            SKENORA_GRADIENT: false,
+            SKENORA_RIM: false,
+            SKENORA_DISSOLVE: false,
+            SKENORA_CLIP: false,
+            SKENORA_NEON: false,
+        });
+        this.#effects = normalizeMaterialEffects(effects);
+        this.doNotSerialize = true;
+        this.registerForExtraEvents = true;
+        this._enable(true);
+    }
+    update(effects) {
+        if (this.#disposed)
+            throw new Error("Material effect instance has been disposed");
+        if (!!effects.gradient !== !!this.#effects.gradient ||
+            !!effects.rim !== !!this.#effects.rim ||
+            !!effects.dissolve !== !!this.#effects.dissolve ||
+            !!effects.clip !== !!this.#effects.clip ||
+            !!effects.neon !== !!this.#effects.neon)
+            throw new Error("Effect composition changes require a prepared replacement");
+        this.#effects = normalizeMaterialEffects(effects);
+    }
+    capture() {
+        return structuredClone(this.#effects);
+    }
+    prepareDefines(defines) {
+        const flags = defines;
+        flags.SKENORA_GRADIENT = this.#effects.gradient !== undefined;
+        flags.SKENORA_RIM = this.#effects.rim !== undefined;
+        flags.SKENORA_DISSOLVE = this.#effects.dissolve !== undefined;
+        flags.SKENORA_CLIP = this.#effects.clip !== undefined;
+        flags.SKENORA_NEON = this.#effects.neon !== undefined;
+    }
+    getClassName() {
+        return "SkenoraSurfaceEffectsV2";
+    }
+    getUniforms() {
+        return {
+            ubo: [
+                { name: "skGradientStart", size: 4, type: "vec4" },
+                { name: "skGradientEnd", size: 4, type: "vec4" },
+                { name: "skGradientRange", size: 4, type: "vec4" },
+                { name: "skRimColor", size: 4, type: "vec4" },
+                { name: "skRimPower", size: 1, type: "float" },
+                { name: "skDissolve", size: 4, type: "vec4" },
+                { name: "skDissolveEdgeColor", size: 4, type: "vec4" },
+                { name: "skDissolveEdgeWidth", size: 1, type: "float" },
+                { name: "skClipPlane", size: 4, type: "vec4" },
+                { name: "skClipOptions", size: 4, type: "vec4" },
+                { name: "skClipEdgeColor", size: 4, type: "vec4" },
+                { name: "skNeonColor", size: 4, type: "vec4" },
+                { name: "skNeonPattern", size: 4, type: "vec4" },
+                { name: "skNeonPulseStrength", size: 1, type: "float" },
+            ],
+            fragment: `
+#ifndef UNIFORMBUFFERS
+uniform vec4 skGradientStart;
+uniform vec4 skGradientEnd;
+uniform vec4 skGradientRange;
+uniform vec4 skRimColor;
+uniform float skRimPower;
+uniform vec4 skDissolve;
+uniform vec4 skDissolveEdgeColor;
+uniform float skDissolveEdgeWidth;
+uniform vec4 skClipPlane;
+uniform vec4 skClipOptions;
+uniform vec4 skClipEdgeColor;
+uniform vec4 skNeonColor;
+uniform vec4 skNeonPattern;
+uniform float skNeonPulseStrength;
+#endif
+`,
+        };
+    }
+    hardBindForSubMesh(buffer) {
+        const gradient = this.#effects.gradient;
+        if (gradient) {
+            const from = gradient.colorStart, to = gradient.colorEnd;
+            buffer.updateFloat4("skGradientStart", from.r, from.g, from.b, gradient.strength ?? 1);
+            buffer.updateFloat4("skGradientEnd", to.r, to.g, to.b, gradient.space === "world" ? 1 : 0);
+            buffer.updateFloat4("skGradientRange", gradient.start ?? 0, gradient.end ?? 1, gradient.axis === "x" ? 0 : gradient.axis === "z" ? 2 : 1, 0);
+        }
+        const rim = this.#effects.rim;
+        if (rim) {
+            buffer.updateFloat4("skRimColor", rim.color.r, rim.color.g, rim.color.b, rim.intensity ?? 1);
+            buffer.updateFloat("skRimPower", rim.power ?? 2);
+        }
+        const dissolve = this.#effects.dissolve;
+        if (dissolve) {
+            const color = dissolve.edgeColor ?? { r: 1, g: 0.3, b: 0.02 };
+            buffer.updateFloat4("skDissolve", dissolve.progress ?? 0, dissolve.scale ?? 8, dissolve.seed ?? 0, dissolve.space === "world" ? 1 : 0);
+            buffer.updateFloat4("skDissolveEdgeColor", color.r, color.g, color.b, dissolve.edgeIntensity ?? 2);
+            buffer.updateFloat("skDissolveEdgeWidth", dissolve.edgeWidth ?? 0.05);
+        }
+        const clip = this.#effects.clip;
+        if (clip) {
+            const normal = clip.planeNormal;
+            const color = clip.edgeColor ?? { r: 0.1, g: 1, b: 0.8 };
+            buffer.updateFloat4("skClipPlane", normal.x, normal.y, normal.z, clip.offset ?? 0);
+            buffer.updateFloat4("skClipOptions", clip.side === "negative" ? -1 : 1, clip.space === "world" ? 1 : 0, clip.edgeWidth ?? 0.03, clip.edgeIntensity ?? 3);
+            buffer.updateFloat4("skClipEdgeColor", color.r, color.g, color.b, 1);
+        }
+        const neon = this.#effects.neon;
+        if (neon) {
+            buffer.updateFloat4("skNeonColor", neon.color.r, neon.color.g, neon.color.b, neon.intensity ?? 4);
+            buffer.updateFloat4("skNeonPattern", neon.scale ?? 4, neon.width ?? 0.045, neon.plane === "xz" ? 1 : neon.plane === "yz" ? 2 : 0, neon.phase ?? 0);
+            buffer.updateFloat("skNeonPulseStrength", neon.pulseStrength ?? 0.35);
+        }
+    }
+    getCustomCode(shaderType) {
+        if (shaderType === "vertex")
+            return {
+                CUSTOM_VERTEX_DEFINITIONS: "#if defined(SKENORA_GRADIENT) || defined(SKENORA_DISSOLVE) || defined(SKENORA_CLIP) || defined(SKENORA_NEON)\nvarying vec3 vSkenoraLocalPosition;\n#endif",
+                CUSTOM_VERTEX_UPDATE_POSITION: "#if defined(SKENORA_GRADIENT) || defined(SKENORA_DISSOLVE) || defined(SKENORA_CLIP) || defined(SKENORA_NEON)\nvSkenoraLocalPosition = positionUpdated;\n#endif",
+            };
+        if (shaderType === "fragment")
+            return {
+                CUSTOM_FRAGMENT_DEFINITIONS: `
+#if defined(SKENORA_GRADIENT) || defined(SKENORA_DISSOLVE) || defined(SKENORA_CLIP) || defined(SKENORA_NEON)
+varying vec3 vSkenoraLocalPosition;
+#endif
+#ifdef SKENORA_DISSOLVE
+float skNoiseHash(vec3 p) {
+  return fract(sin(dot(p, vec3(127.1, 311.7, 74.7)) + skDissolve.z) * 43758.5453);
+}
+float skValueNoise(vec3 p) {
+  vec3 cell = floor(p);
+  vec3 f = fract(p);
+  vec3 w = f * f * (3.0 - 2.0 * f);
+  float low = mix(mix(skNoiseHash(cell), skNoiseHash(cell + vec3(1.0, 0.0, 0.0)), w.x),
+    mix(skNoiseHash(cell + vec3(0.0, 1.0, 0.0)), skNoiseHash(cell + vec3(1.0, 1.0, 0.0)), w.x), w.y);
+  float high = mix(mix(skNoiseHash(cell + vec3(0.0, 0.0, 1.0)), skNoiseHash(cell + vec3(1.0, 0.0, 1.0)), w.x),
+    mix(skNoiseHash(cell + vec3(0.0, 1.0, 1.0)), skNoiseHash(cell + vec3(1.0, 1.0, 1.0)), w.x), w.y);
+  return mix(low, high, w.z);
+}
+#endif
+`,
+                CUSTOM_FRAGMENT_UPDATE_ALPHA: `
+#ifdef SKENORA_CLIP
+float skClipEdge = 0.0;
+vec3 skClipPosition = mix(vSkenoraLocalPosition, vPositionW, skClipOptions.y);
+float skClipDistance = (dot(skClipPosition, skClipPlane.xyz) - skClipPlane.w) * skClipOptions.x;
+if (skClipDistance < 0.0) discard;
+if (skClipOptions.z > 0.0) skClipEdge = 1.0 - smoothstep(0.0, skClipOptions.z, skClipDistance);
+#endif
+#ifdef SKENORA_DISSOLVE
+float skDissolveEdge = 0.0;
+if (skDissolve.x >= 1.0) discard;
+if (skDissolve.x > 0.0) {
+  vec3 skMaskPosition = mix(vSkenoraLocalPosition, vPositionW, skDissolve.w);
+  float skMask = skValueNoise(skMaskPosition * skDissolve.y);
+  if (skMask < skDissolve.x) discard;
+  if (skDissolveEdgeWidth > 0.0) skDissolveEdge = 1.0 - smoothstep(0.0, skDissolveEdgeWidth, skMask - skDissolve.x);
+}
+#endif
+`,
+                CUSTOM_FRAGMENT_BEFORE_LIGHTS: `
+#ifdef SKENORA_GRADIENT
+vec3 skPosition = mix(vSkenoraLocalPosition, vPositionW, skGradientEnd.a);
+float skCoordinate = skGradientRange.z < 0.5 ? skPosition.x : (skGradientRange.z < 1.5 ? skPosition.y : skPosition.z);
+float skRamp = clamp((skCoordinate - skGradientRange.x) / max(skGradientRange.y - skGradientRange.x, 0.000001), 0.0, 1.0);
+surfaceAlbedo = mix(surfaceAlbedo, mix(skGradientStart.rgb, skGradientEnd.rgb, skRamp), skGradientStart.a);
+#endif
+`,
+                CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION: `
+#ifdef SKENORA_DISSOLVE
+finalEmissive += skDissolveEdgeColor.rgb * skDissolveEdgeColor.a * skDissolveEdge;
+#endif
+#ifdef SKENORA_CLIP
+finalEmissive += skClipEdgeColor.rgb * skClipOptions.w * skClipEdge;
+#endif
+#ifdef SKENORA_RIM
+float skRim = pow(1.0 - clamp(abs(dot(normalize(normalW), viewDirectionW)), 0.0, 1.0), skRimPower);
+finalEmissive += skRimColor.rgb * skRimColor.a * skRim;
+#endif
+#ifdef SKENORA_NEON
+vec2 skNeonUv = skNeonPattern.z < 0.5
+  ? vSkenoraLocalPosition.xy
+  : (skNeonPattern.z < 1.5 ? vSkenoraLocalPosition.xz : vSkenoraLocalPosition.yz);
+vec2 skNeonCell = fract(vec2(skNeonUv.x + skNeonUv.y * 0.5, skNeonUv.y * 0.8660254) * skNeonPattern.x) - 0.5;
+float skNeonDistance = min(abs(skNeonCell.y), min(abs(0.8660254 * skNeonCell.x + 0.5 * skNeonCell.y), abs(-0.8660254 * skNeonCell.x + 0.5 * skNeonCell.y)));
+float skNeonLine = 1.0 - smoothstep(skNeonPattern.y, skNeonPattern.y + 0.015, skNeonDistance);
+float skNeonPulse = mix(1.0, 0.55 + 0.45 * sin(6.2831853 * (skNeonPattern.w + skNeonUv.y * 0.12)), skNeonPulseStrength);
+finalEmissive += skNeonColor.rgb * skNeonColor.a * skNeonLine * skNeonPulse;
+#endif
+`,
+            };
+        return null;
+    }
+    dispose() {
+        this.#disposed = true;
+    }
+}
+//# sourceMappingURL=surface-effect-plugin.js.map

package/dist/systems/surface-effect-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-effect-plugin.js","sourceRoot":"","sources":["../../src/systems/surface-effect-plugin.ts"],"names":[],"mappings":"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"}

package/dist/systems/surface-program-plugin.d.ts

@@ -0,0 +1,29 @@
+import type { MaterialDefines } from "@babylonjs/core/Materials/materialDefines";
+import { MaterialPluginBase } from "@babylonjs/core/Materials/materialPluginBase";
+import type { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { UniformBuffer } from "@babylonjs/core/Materials/uniformBuffer";
+import { type MaterialProgram } from "@skenora/contracts";
+import type { PreparedGpuProgram } from "./gpu-program-cache.js";
+/** One trusted compiler-backed plugin per owned material; authored GLSL is never accepted. */
+export declare class SurfaceProgramPlugin extends MaterialPluginBase {
+    private program;
+    private compiled;
+    private artifact;
+    private disposed;
+    constructor(material: PBRMaterial, program: MaterialProgram, prepared?: Pick<PreparedGpuProgram, "compiled" | "artifact">);
+    update(program: MaterialProgram, prepared?: Pick<PreparedGpuProgram, "compiled" | "artifact">): void;
+    prepareDefines(defines: MaterialDefines): void;
+    getClassName(): string;
+    getUniforms(): {
+        ubo: {
+            name: string;
+            size: number;
+            type: string;
+        }[];
+        fragment: string;
+    };
+    hardBindForSubMesh(buffer: UniformBuffer): void;
+    getCustomCode(shaderType: string): Record<string, string> | null;
+    dispose(): void;
+}
+//# sourceMappingURL=surface-program-plugin.d.ts.map

package/dist/systems/surface-program-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-program-plugin.d.ts","sourceRoot":"","sources":["../../src/systems/surface-program-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,8FAA8F;AAC9F,qBAAa,oBAAqB,SAAQ,kBAAkB;IAC1D,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,QAAQ,CAAS;gBAGvB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,CAAC;IAc9D,MAAM,CACJ,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,CAAC,GAC3D,IAAI;IAWE,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAM9C,YAAY,IAAI,MAAM;IAItB,WAAW;;;;;;;;IAeX,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAkB/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAiEhE,OAAO,IAAI,IAAI;CAMzB"}