@zakkster/lite-ui-fx 1.0.5 → 1.2.0

package/llms.txt

@@ -1,7 +1,7 @@
 # @zakkster/lite-ui-fx
 > Canvas-hijacked UI components with pluggable recipe system. 50 built-in recipes.
 
-VERSION 1.0.5
+VERSION 1.2.0
 
 ## Install
 npm i @zakkster/lite-ui-fx
@@ -14,31 +14,42 @@ Recipe = { tick(), init?(), onHover?(), onClick?(), onToggle?(), onDrag?(), dest
 ## Import -- Controller
 import { mountUIFX, UIType } from '@zakkster/lite-ui-fx';
 
-## Import -- Recipes (3 volumes, 50 total)
-import { SwarmToggle, MagneticButton, SparkSlider } from './recipes/UIFXRecipes.js';
-import { PendulumToggle, HeartbeatButton, AuroraSlider } from './recipes/UIFXRecipes2.js';
-import { VolumeKnob, WaterLevel, TimerCountdown } from './recipes/UIFXRecipes3.js';
+## Import -- Recipes (one ./recipes subpath, 50 total, tree-shakeable)
+import { SwarmToggle, MagneticButton, SparkSlider } from '@zakkster/lite-ui-fx/recipes';
+import { PendulumToggle, HeartbeatButton, AuroraSlider } from '@zakkster/lite-ui-fx/recipes';
+import { VolumeKnob, WaterLevel, TimerCountdown } from '@zakkster/lite-ui-fx/recipes';
+
+## Import -- Recipe registry (data-driven pickers)
+import { RECIPES, RECIPE_META, RECIPE_NAMES, registerRecipe, mountRecipe } from '@zakkster/lite-ui-fx/recipes';
+// RECIPES id->factory (null-proto); RECIPE_META { id, name, type, family, themeable, motionSafe }; RECIPE_NAMES frozen.
+// mountRecipe(container, id, options?): resolves id fail-closed (did-you-mean), asserts META.type, mounts.
 
 ## Mount
 const instance = mountUIFX(container, UIType.TOGGLE, SwarmToggle, { label: 'Sound' });
 instance.destroy(); // cleanup
 
+## Options (4th arg; unknown option or recipe-hook keys throw a did-you-mean -- fail closed)
+width, height, padding=40, label   // geometry + accessible label
+value     // slider start, number 0..1 (default 0.5); out-of-range or non-number throws
+checked   // toggle start, boolean (default false)
+disabled  // native disabled attr + state.disabled for recipes to render
+
 ## Element Types
 UIType.TOGGLE -> <input type="checkbox" role="switch"> -> state.toggled, onToggle(checked)
 UIType.BUTTON -> <button> -> state.active, onClick(x, y, state)
 UIType.SLIDER -> <input type="range"> -> state.val (0-1), onDrag(val, velocity)
 
 ## State Object (provided to tick every frame)
-{ hover, active, focused, toggled, val, w, h, padding, dpr }
+{ hover, active, focused, toggled, disabled, val, w, h, padding, dpr }
 
 ## 50 Built-in Recipes
 
-### Vol. 1 (UIFXRecipes.js) -- 10 recipes
+### Vol. 1 -- 10 recipes
 Toggles: SwarmToggle, LiquidToggle, NeonPulseToggle
 Buttons: MagneticButton, ShatterButton, ConfettiButton, GlitchButton
 Sliders: SparkSlider, CosmicSlider, LaserSlider
 
-### Vol. 2 (UIFXRecipes2.js) -- 20 recipes
+### Vol. 2 -- 20 recipes
 Toggles: PendulumToggle, CircuitToggle, LightningToggle, DNAToggle
 Buttons: HeartbeatButton, BreathingButton, InkSplashButton, PixelDissolveButton, FireworkButton
 Sliders: AuroraSlider, WaveSlider, ElasticBandSlider, GravitySlider
@@ -47,7 +58,7 @@ Checkboxes: RippleCheck, MorphCheck
 Counters: FlameCounter, GlitchCounter
 Rating: BubbleRating
 
-### Vol. 3 (UIFXRecipes3.js) -- 20 recipes
+### Vol. 3 -- 20 recipes
 Knobs: VolumeKnob, CompassKnob
 Progress: RingProgress, BatteryGauge, SignalMeter
 Controls: PillTabs, Stepper, RadioOrbit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zakkster/lite-ui-fx",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "description": "Canvas-hijacked UI components with a pluggable recipe system. 50 built-in recipes across toggles, buttons, sliders, knobs, loaders, checkboxes, counters, and ratings.",
   "author": "Zahary Shinikchiev <shinikchiev@yahoo.com>",
   "license": "MIT",
@@ -12,13 +12,19 @@
     ".": {
       "import": "./UIFXController.js",
       "types": "./UIFXController.d.ts"
+    },
+    "./recipes": {
+      "import": "./UIFXRecipes.js",
+      "types": "./UIFXRecipes.d.ts"
     }
   },
   "files": [
     "UIFXController.js",
     "UIFXController.d.ts",
+    "UIFXRecipes.js",
+    "UIFXRecipes.d.ts",
+    "UIFX-RECIPE-GUIDE.md",
     "llms.txt",
-    "recipes/UIFX-RECIPE-GUIDE.md",
     "CHANGELOG.md",
     "README.md",
     "LICENSE"
@@ -41,14 +47,15 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@zakkster/lite-ticker": "^1.0.0",
     "@zakkster/lite-lerp": "^1.0.0",
-    "@zakkster/lite-random": "^1.0.0"
+    "@zakkster/lite-random": "^1.0.0",
+    "@zakkster/lite-ticker": "^1.0.0"
   },
   "devDependencies": {
     "@zakkster/lite-gc-profiler": "^1.16.0",
     "@zakkster/lite-leak": "^1.10.0",
-    "@zakkster/lite-signal": "^1.5.1"
+    "@zakkster/lite-signal": "^1.5.1",
+    "esbuild": "^0.28.2"
   },
   "scripts": {
     "test": "node --test test/*.test.mjs",