gaugeit.js 0.1.0 → 0.1.1

package/docs/api.md

@@ -162,11 +162,14 @@ types that include `Gaugeit.layers.light`. It is disabled by default.
 
 ```js
 light: {
-  visible: true,
-  x: 108,
+  visible: false,
+  x: 93,
   y: 110,
-  radius: 10,
-  color: 'amber',
+  radius: 8,
+  glowRadius: 20,
+  glowSharpness: 0,
+  glowOpacity: 0.15,
+  color: 'red',
   customColor: '',
   offColor: '#f3ead6',
   offEdgeColor: '#817768',
@@ -175,10 +178,15 @@ light: {
   opacity: 1,
   on: false,
   glow: true,
-  pulse: true,
+  pulse: false,
   pulseInterval: 2600,
-  blink: true,
+  blink: false,
   blinkInterval: 1000,
+  flicker: true,
+  flickerIntensity: 0.1,
+  flickerGlowRadius: 0.1,
+  flickerMinInterval: 45,
+  flickerMaxInterval: 140,
   trigger: { mode: 'below', source: 'target', value: 15, min: 0, max: 15 }
 }
 ```
@@ -186,16 +194,23 @@ light: {
 - `visible`: render or omit the component;
 - `x`, `y`: logical SVG coordinates; linear Y values use the positive-up convention;
 - `radius`: bulb radius in logical gauge units;
+- `glowRadius`: active halo radius in logical gauge units, default `20`; set `null` to derive it from `radius * 1.82`;
+- `glowSharpness`: halo blur from `0` (soft Gaussian glow) to `1` (no blur and a sharp edge), default `0`;
+- `glowOpacity`: halo-only opacity from 0 to 1, default `0.15`; independent from the illuminated lens opacity;
 - `color`: `red`, `green`, `blue`, `amber`, `yellow`, `orange`, `white`, `halogen`, `cyan`, or `brown`;
 - `customColor`: optional CSS color overriding the selected active palette;
 - `offColor`, `offEdgeColor`: unlit diffused-lens center and edge colors;
 - `bezelColor`, `bezelHighlightColor`: panel-mount bezel colors;
-- `opacity`: total bulb opacity;
+- `opacity`: illuminated-lens opacity; does not fade the halo, unlit lamp, bezel, or physical hardware;
 - `on`: manual state used by `trigger.mode: 'manual'`;
 - `glow`: enable the active halo;
 - `pulse`, `pulseInterval`: subtle steady-light breathing effect and period;
 - `blink`: blink while the condition is active; the off half-cycle renders the full normal unlit-lens appearance instead of fading the whole lamp;
 - `blinkInterval`: complete blink period in milliseconds, minimum 100;
+- `flicker`: enable rapid randomized brightness variation, default `true`; it may run together with pulse or blink and remains invisible while the lamp is hidden or inactive;
+- `flickerIntensity`: maximum randomized loss from full emitted light, from `0` (steady) to `1` (may reach the normal unlit-lens appearance), default `0.1`;
+- `flickerGlowRadius`: maximum relative plus/minus variation of `glowRadius`, from 0 to 1, default `0.1`; with `glowRadius: 20`, the default produces 18–22;
+- `flickerMinInterval`, `flickerMaxInterval`: randomized delay range in milliseconds, defaults `45` and `140`, minimum 16;
 - `trigger.mode`: `manual`, `below`, `above`, or `between`;
 - `trigger.value`: inclusive threshold for `below` and `above`;
 - `trigger.min`, `trigger.max`: inclusive bounds for `between`.
@@ -206,6 +221,18 @@ pointer animation. Set `trigger.source` to `displayed` to follow the animated va
 unresolved SVG custom-property references, keeping the lens rendering consistent across
 browsers and DOM test environments.
 
+Every built-in gauge type uses this same light configuration. Partial `light` objects are
+deeply merged with the shared defaults, so `light: { visible: true }` is enough to enable
+the standard lamp. Override `x` and `y` when a gauge layout needs another position.
+
+Pulse and blink are alternative base effects: blink takes precedence if both are true.
+Flicker is an independent overlay and therefore remains compatible with either one.
+Flicker varies the illuminated lens and glow opacities from their independently configured
+levels instead of applying a black brightness filter, so a zero light level is visually
+identical to switching off. The glow is painted below the opaque lamp hardware and is
+therefore visible only outside the lamp edges.
+All motion effects are suppressed when the browser requests reduced motion.
+
 ## `face`
 
 `face` controls the optional old-style instrument background.

package/docs/architecture.md

@@ -53,8 +53,16 @@ Built-in types are registered during module initialization. Applications may reg
 layer owns only SVG nodes and CSS state classes. This lets any built-in or custom type
 insert the same component at its preferred paint position without duplicating timers,
 threshold logic, gradients, or responsive calculations. Thresholds may read the stable
-target, animated display, or jittered pointer value. Blinking is CSS-driven and respects
-`prefers-reduced-motion`.
+target, animated display, or jittered pointer value. Blinking and pulsing are CSS-driven.
+Flicker uses a single randomized timer per active lamp. It varies the illuminated SVG
+group's inherited opacity over an always-opaque unlit base. The glow is a separate
+opacity-controlled SVG group painted below the opaque bezel and lens, and flicker can
+also vary its radius. The effect can be layered over blink or pulse, is cleaned up with
+the layer controller, and respects `prefers-reduced-motion`.
+
+The glow uses an SVG Gaussian blur filter. Its normalized sharpness scales the
+blur deviation down continuously: zero preserves the soft default and one sets the
+deviation to zero for a hard edge.
 
 ### Rendering layers
 

package/docs/creating-gauge-types.md

@@ -40,7 +40,8 @@ Layer order is paint order. Later SVG layers appear above earlier layers.
 
 For a standard warning or status lamp, include `Gaugeit.layers.light` and provide a
 normal `light` option block. The shared component already supplies threshold/range
-conditions, realistic palettes, blinking, custom colors, and responsive positioning.
+conditions, realistic palettes, independent lamp/glow sizing and edge sharpness,
+blinking, randomized flicker, custom colors, and responsive positioning.
 A custom lamp layer is only necessary when the visual itself is fundamentally different.
 
 Any custom radial type that includes `Gaugeit.layers.zones` automatically supports both

package/docs/development.md

@@ -1,7 +1,7 @@
 # Development and release process
 
-Gaugeit.js `0.1.0` is the first release line. The repository is structured so the same
-canonical sources produce every npm, Composer, GitHub, and CDN-facing artifact.
+Gaugeit.js uses the same canonical sources for every npm, Composer, GitHub, and
+CDN-facing artifact.
 Publishing remains an explicit maintainer action; CI validates but does not publish.
 
 ## Source of truth

package/docs/framework-integration.md

@@ -25,7 +25,7 @@ destroys the instance on unmount.
 Install the recommended prebuilt assets:
 
 ```bash
-vendor/bin/gaugeit-install-assets public/assets/vendor/gaugeit/0.1.0
+vendor/bin/gaugeit-install-assets public/assets/vendor/gaugeit/0.1.1
 ```
 
 The default command installs `gaugeit.umd.min.js` and `gaugeit.min.css`. Pass
@@ -51,7 +51,7 @@ as `window.initGaugeitStatGauges(root)` for fragments inserted later.
 A reusable initializer can keep instances in a `WeakMap`:
 
 ```js
-import { createGauge } from './vendor/gaugeit/0.1.0/gaugeit.esm.js';
+import { createGauge } from './vendor/gaugeit/0.1.1/gaugeit.esm.js';
 
 const instances = new WeakMap();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaugeit.js",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Dependency-free, extensible SVG gauge instruments for browsers, React, Laravel, and modern web applications.",
   "license": "MIT",
   "author": {