@sharedex/ui 0.0.0-stage → 0.9.0

package/dist/index.js

@@ -0,0 +1,373 @@
+// ---------------------------------------------------------------------------
+// @sharedex/ui — the carousel, the ticker, the grid, page sections and background effects.
+//
+// Config for numbers. Pure functions for motion. Children for markup.
+// Hooks for anything that writes.
+// ---------------------------------------------------------------------------
+// --- parts ---
+export { Carousel, Root, Viewport, Track, Window, Slot, Parallax, Shader, Panel, useCarouselStyle } from "./carousel/parts/index.js";
+// --- engine ---
+export { useCarouselEngine } from "./carousel/engine/useCarouselEngine.js";
+export { useCarouselHandle, useCarouselEngineRef, useCarouselMotion, useCarouselData, CarouselMotionContext, CarouselDataContext, } from "./carousel/engine/handle.js";
+export { createSlotFrameBuffer, resetSlotFrameBuffer } from "./carousel/engine/types.js";
+export { buildRing, wrapIndex, shortestDelta, ringLengthFor, mountHalfFor, mountSpanFor, PLACEHOLDER, } from "./carousel/engine/ring.js";
+// --- per-slot, for arbitrary card designs ---
+export { useSlotState, useSlotValue, useSlotOpen } from "./carousel/slot/context.js";
+// --- layout ---
+export { composeLayout, composeAxialLayout, modify, applyLayout, serializeTransform } from "./carousel/layout/types.js";
+export { makeCurve } from "./carousel/layout/curve.js";
+export { track } from "./carousel/layout/modifiers/track.js";
+export { scaleCurve } from "./carousel/layout/modifiers/scaleCurve.js";
+export { place3d, turnInPlace } from "./carousel/layout/modifiers/place3d.js";
+export { speedWave, speedTilt } from "./carousel/layout/modifiers/speed.js";
+export { morphCurve, blendBuffers, DEFAULT_MORPH } from "./carousel/engine/morph.js";
+export { presence } from "./carousel/layout/presence.js";
+export { openView } from "./carousel/layout/open.js";
+export { presenceProgress } from "./carousel/engine/presence.js";
+export { converge } from "./carousel/layout/modifiers/converge.js";
+export { curve } from "./carousel/layout/modifiers/curve.js";
+export { wave, WAVE_DISTANCE, WAVE_SCALE } from "./carousel/layout/presets/wave.js";
+export { coverflow } from "./carousel/layout/presets/coverflow.js";
+export { fan } from "./carousel/layout/presets/fan.js";
+export { spotlight } from "./carousel/layout/presets/spotlight.js";
+export { deck } from "./carousel/layout/presets/deck.js";
+export { scale } from "./carousel/layout/presets/scale.js";
+export { stack } from "./carousel/layout/modifiers/stack.js";
+export { pack, packedOffset, packedSize } from "./carousel/layout/modifiers/pack.js";
+export { panorama } from "./carousel/layout/presets/panorama.js";
+export { expo } from "./carousel/layout/presets/expo.js";
+export { material } from "./carousel/layout/presets/material.js";
+export { superFlow } from "./carousel/layout/presets/superFlow.js";
+export { barrel } from "./carousel/layout/presets/barrel.js";
+export { helix } from "./carousel/layout/presets/helix.js";
+export { ring } from "./carousel/layout/presets/ring.js";
+export { staircase } from "./carousel/layout/presets/staircase.js";
+export { fallAway } from "./carousel/layout/presets/fallAway.js";
+export { sphere, spherePath, spherePlacement, eulerXYZ } from "./carousel/layout/presets/sphere.js";
+// --- transitions: the one-card carousel mode (and section reveals, later) ---
+export { stage, fillViewport, transitionLayout } from "./transitions/stage.js";
+export { TRANSITION_EFFECTS, TRANSITION_IDS } from "./transitions/registry.js";
+export { TRANSITION_BASE_CSS } from "./transitions/progress.js";
+export { Reveal } from "./transitions/reveal/index.js";
+export { wipe } from "./transitions/effects/css/wipe.js";
+export { iris } from "./transitions/effects/css/iris.js";
+export { diagonal } from "./transitions/effects/css/diagonal.js";
+export { splitCurtain } from "./transitions/effects/css/splitCurtain.js";
+export { colorBlock } from "./transitions/effects/css/colorBlock.js";
+export { gradientMask } from "./transitions/effects/css/gradientMask.js";
+export { blurSharp } from "./transitions/effects/css/blurSharp.js";
+export { pixelGrid, PIXEL_GRID_MAX_CELLS } from "./transitions/effects/css/pixelGrid.js";
+export { shutters } from "./transitions/effects/css/shutters.js";
+export { slicer } from "./transitions/effects/css/slicer.js";
+export { fadeUp, blurFade, zoomOut } from "./transitions/effects/css/reveals.js";
+export { blinds, columnWave, randomGrid, RANDOM_GRID_MAX_CELLS } from "./transitions/effects/css/shapes.js";
+export { ink, gooey } from "./transitions/effects/css/paint.js";
+// shader transitions (Carousel.Shader, <Reveal image>)
+export { displacement, stretchWarp, ripple, chromaticShift, liquidMorph } from "./transitions/effects/shader/warps.js";
+export { pixelDissolve, noiseBurn } from "./transitions/effects/shader/dissolves.js";
+export { crossZoom, swirl, dreamy, directionalWarp, morph, gridFlip } from "./transitions/effects/shader/collection.js";
+export { pageCurl } from "./transitions/effects/shader/pageCurl.js";
+export { ScrollDistort } from "./transitions/reveal/ScrollDistort.js";
+// scroll compositions
+export { Curtain } from "./transitions/scroll/Curtain.js";
+export { StackCards } from "./transitions/scroll/StackCards.js";
+export { PinnedExpand } from "./transitions/scroll/PinnedExpand.js";
+export { TextMaskZoom } from "./transitions/scroll/TextMaskZoom.js";
+export { SplitText } from "./transitions/scroll/SplitText.js";
+export { splitWords } from "./transitions/scroll/split.js";
+export { MAX_TEXTURES } from "./transitions/shader/textures.js";
+export { fade } from "./transitions/effects/stage/fade.js";
+export { cube } from "./transitions/effects/stage/cube.js";
+export { flip } from "./transitions/effects/stage/flip.js";
+export { cards } from "./transitions/effects/stage/cards.js";
+export { creative } from "./transitions/effects/stage/creative.js";
+export { push } from "./transitions/effects/stage/push.js";
+export { cardStack } from "./transitions/effects/stage/cardStack.js";
+export { tinder } from "./transitions/effects/stage/tinder.js";
+// --- physics ---
+export { momentumSnap, snapToNearest, freeScroll, pagedBy } from "./carousel/physics/policies.js";
+export { inertiaLanding } from "./carousel/physics/landing.js";
+export { rubberband, noOverdrag } from "./carousel/physics/rubberband.js";
+// --- input sources ---
+export { useDrag } from "./carousel/input/useDrag.js";
+export { useAutoplay } from "./carousel/input/useAutoplay.js";
+export { useScrollLink, scrollLinkPosition } from "./carousel/input/useScrollLink.js";
+// --- config ---
+export { DEFAULT_CONFIG, defineCarouselDefaults, resolveConfig } from "./carousel/config.js";
+// --- data ---
+export { defaultFilterPredicate } from "./carousel/types.js";
+// --- ticker: a continuous marquee (its own component, not a carousel option) ---
+export { Ticker } from "./ticker/Ticker.js";
+export { tickerCopies, wrapOffset, tickerShift, tickerFade } from "./ticker/math.js";
+// --- grid: an endless plane of cards panned in any direction (its own component) ---
+export { Grid, GridRoot, GridViewport, GridPanel } from "./grid/index.js";
+export { useGrid, useGridCell } from "./grid/context.js";
+export { gridOpen, screenToStage, focusWeight } from "./grid/open.js";
+export { useGridEngine } from "./grid/useGridEngine.js";
+export { bulge, fog } from "./grid/modifiers.js";
+export { gridItemAt, gridColumns, rowShift, cellCentre, tiltMatrix, planeHit, visibleCells, nearestCopy, snapTarget, bulgeAt, } from "./grid/math.js";
+export { latticeOffset, planeOffset, readCell, poseCell } from "./grid/pose.js";
+// --- buttons: a button that wears any number of effects (effects = plain descriptors) ---
+export { Button } from "./buttons/Button.js";
+export { BUTTON_EFFECTS, BUTTON_IDS } from "./buttons/registry.js";
+export { claimConflicts } from "./buttons/claims.js";
+export { BUTTON_GROUPS, BUTTON_STATUSES } from "./buttons/types.js";
+export { fillFade } from "./buttons/effects/fill/fillFade.js";
+export { fillSweep } from "./buttons/effects/fill/fillSweep.js";
+export { fillRadial } from "./buttons/effects/fill/fillRadial.js";
+export { fillShutter } from "./buttons/effects/fill/fillShutter.js";
+export { fillSlash } from "./buttons/effects/fill/fillSlash.js";
+export { fillGradient } from "./buttons/effects/fill/fillGradient.js";
+export { fillWave } from "./buttons/effects/fill/fillWave.js";
+export { pressScale } from "./buttons/effects/press/pressScale.js";
+export { borderUnderline } from "./buttons/effects/border/borderUnderline.js";
+export { borderDraw } from "./buttons/effects/border/borderDraw.js";
+export { borderOutline } from "./buttons/effects/border/borderOutline.js";
+export { borderRound } from "./buttons/effects/border/borderRound.js";
+export { borderConic } from "./buttons/effects/border/borderConic.js";
+export { borderRunner } from "./buttons/effects/border/borderRunner.js";
+export { borderSpread } from "./buttons/effects/border/borderSpread.js";
+export { borderBeam } from "./buttons/effects/border/borderBeam.js";
+export { borderStar } from "./buttons/effects/border/borderStar.js";
+export { borderAnts } from "./buttons/effects/border/borderAnts.js";
+export { glowHover } from "./buttons/effects/glow/glowHover.js";
+export { glowLift } from "./buttons/effects/glow/glowLift.js";
+export { glowShine } from "./buttons/effects/glow/glowShine.js";
+export { glowShimmer } from "./buttons/effects/glow/glowShimmer.js";
+export { glowRainbow } from "./buttons/effects/glow/glowRainbow.js";
+export { glowShiny } from "./buttons/effects/glow/glowShiny.js";
+export { glowGlare } from "./buttons/effects/glow/glowGlare.js";
+export { glowNeon } from "./buttons/effects/glow/glowNeon.js";
+export { glowAura } from "./buttons/effects/glow/glowAura.js";
+export { depthPushable } from "./buttons/effects/depth/depthPushable.js";
+export { depthGrow } from "./buttons/effects/depth/depthGrow.js";
+export { depthFloat } from "./buttons/effects/depth/depthFloat.js";
+export { depthJiggle } from "./buttons/effects/depth/depthJiggle.js";
+export { depthFlip } from "./buttons/effects/depth/depthFlip.js";
+export { depthCube } from "./buttons/effects/depth/depthCube.js";
+export { depthNeumorph } from "./buttons/effects/depth/depthNeumorph.js";
+export { fillDirectional } from "./buttons/effects/fill/fillDirectional.js";
+export { fillSpotlight } from "./buttons/effects/fill/fillSpotlight.js";
+export { depthTilt } from "./buttons/effects/depth/depthTilt.js";
+export { cursorMagnet } from "./buttons/effects/cursor/cursorMagnet.js";
+export { cursorBlob } from "./buttons/effects/cursor/cursorBlob.js";
+export { labelRoll } from "./buttons/effects/label/labelRoll.js";
+export { labelSwap } from "./buttons/effects/label/labelSwap.js";
+export { labelFall } from "./buttons/effects/label/labelFall.js";
+export { labelScramble, scrambleText } from "./buttons/effects/label/labelScramble.js";
+export { labelShiny } from "./buttons/effects/label/labelShiny.js";
+export { iconNudge } from "./buttons/effects/icon/iconNudge.js";
+export { iconReveal } from "./buttons/effects/icon/iconReveal.js";
+export { iconExpand } from "./buttons/effects/icon/iconExpand.js";
+export { iconMorph } from "./buttons/effects/icon/iconMorph.js";
+export { pressRipple } from "./buttons/effects/press/pressRipple.js";
+export { pressSpark } from "./buttons/effects/press/pressSpark.js";
+export { pressBurst } from "./buttons/effects/press/pressBurst.js";
+export { pressConfetti } from "./buttons/effects/press/pressConfetti.js";
+export { pressSpray } from "./buttons/effects/press/pressSpray.js";
+export { pressJelly } from "./buttons/effects/press/pressJelly.js";
+export { stateShake } from "./buttons/effects/press/stateShake.js";
+export { stateSpinner } from "./buttons/effects/state/stateSpinner.js";
+export { stateSwap } from "./buttons/effects/state/stateSwap.js";
+export { stateMorph } from "./buttons/effects/state/stateMorph.js";
+export { stateProgress } from "./buttons/effects/state/stateProgress.js";
+export { stateRing } from "./buttons/effects/state/stateRing.js";
+export { stateHold } from "./buttons/effects/state/stateHold.js";
+export { stateCopy } from "./buttons/effects/state/stateCopy.js";
+export { fillGoo } from "./buttons/effects/fill/fillGoo.js";
+export { borderElectric } from "./buttons/effects/border/borderElectric.js";
+export { idlePing } from "./buttons/effects/idle/idlePing.js";
+export { idleBreathe } from "./buttons/effects/idle/idleBreathe.js";
+export { idleWiggle } from "./buttons/effects/idle/idleWiggle.js";
+export { idleGrain } from "./buttons/effects/idle/idleGrain.js";
+export { glassBlur } from "./buttons/effects/glass/glassBlur.js";
+export { glassLiquid } from "./buttons/effects/glass/glassLiquid.js";
+export { glassNative } from "./buttons/effects/glass/glassNative.js";
+export { glassRefract } from "./buttons/effects/glass/glassRefract.js";
+export { glassDistort } from "./buttons/effects/glass/glassDistort.js";
+export { pickEffect } from "./buttons/pick.js";
+export { useButtonAction } from "./buttons/runtime/useButtonAction.js";
+export { nextButtonState } from "./buttons/runtime/state.js";
+export { splitLabel, graphemes } from "./buttons/runtime/split.js";
+// --- sections: headless page sections (layout + content + semantics) ---
+// Default looks live in theme.css / styles/ as components-layer CSS. Each compound object and its layout ids
+// come from the section's plain index.ts (not its "use client" module), so Server Components can use them.
+export { Hero, HERO_LAYOUTS } from "./sections/hero/index.js";
+export { About, ABOUT_LAYOUTS } from "./sections/about/index.js";
+export { Services, SERVICES_LAYOUTS } from "./sections/services/index.js";
+export { Contact, CONTACT_LAYOUTS } from "./sections/contact/index.js";
+export { sectionRootAttrs, partAttrs } from "./sections/shared/attrs.js";
+export { resolveReveal, revealAttrs, SECTION_REVEAL_CSS } from "./sections/shared/reveal.js";
+// --- backgrounds: decorative layers behind content (effects = pure descriptors) ---
+export { Background } from "./backgrounds/parts/index.js";
+export { useBackgroundRuntime } from "./backgrounds/runtime/context.js";
+export { DEFAULT_BACKGROUND_CONFIG, resolveBackgroundConfig } from "./backgrounds/config.js";
+export { BACKGROUND_CATEGORIES, BACKGROUND_FAMILIES, EFFECT_TIERS, DEVICE_TIERS, } from "./backgrounds/types.js";
+export { BACKGROUND_EFFECTS, BACKGROUND_SLOTS } from "./backgrounds/registry.js";
+export { classifyTier, tierAllows } from "./backgrounds/runtime/tier.js";
+export { rng, between } from "./backgrounds/runtime/rng.js";
+export { defineCssEffect, defineCanvasEffect, defineSvgEffect, defineWebglEffect, defineGpuEffect, duration, layerVars, maskValue, liteMeta, svgUrl } from "./backgrounds/effects/define.js";
+export { scrollProgress, scrollVars, RESTING_SCROLL } from "./backgrounds/runtime/scroll.js";
+export { STANDARD_UNIFORMS, FRAGMENT_HEADER, FULLSCREEN_VERTEX, declaredUniforms, usedUniforms, WebglUnavailable, fragmentProgram, link, setUniform, fullscreenTriangle, createTarget, disposeTarget, pingPong, renderTo, bindTexture, requireFloatTargets, } from "./backgrounds/runtime/webgl.js";
+export { GLSL_NOISE, GLSL_SPACE, GLSL_OUT, slots, stillFallback } from "./backgrounds/effects/shaderKit.js";
+export { noise3, fbm } from "./backgrounds/runtime/noise.js";
+export { parseRgb, rgba } from "./backgrounds/runtime/color.js";
+// effects
+export { cursorGlow } from "./backgrounds/effects/cursor/cursorGlow.js";
+export { filmGrain } from "./backgrounds/effects/texture/filmGrain.js";
+export { crtScanlines } from "./backgrounds/effects/glitch/crtScanlines.js";
+export { aurora } from "./backgrounds/effects/shader/aurora.js";
+export { gradientGrid } from "./backgrounds/effects/grid/gradientGrid.js";
+export { fadingGrid } from "./backgrounds/effects/grid/fadingGrid.js";
+export { dotPattern } from "./backgrounds/effects/grid/dotPattern.js";
+export { ripples } from "./backgrounds/effects/wave/ripples.js";
+export { bokeh } from "./backgrounds/effects/particle/bokeh.js";
+export { meteors } from "./backgrounds/effects/particle/meteors.js";
+export { foggyGlass, frozenGlass } from "./backgrounds/effects/texture/glass.js";
+export { digitalGlitch } from "./backgrounds/effects/glitch/digitalGlitch.js";
+export { retroScreen } from "./backgrounds/effects/glitch/retroScreen.js";
+export { rgbShift } from "./backgrounds/effects/glitch/rgbShift.js";
+export { isometricLayers } from "./backgrounds/effects/glass/isometricLayers.js";
+export { rainbow } from "./backgrounds/effects/shader/rainbow.js";
+export { gradientBars } from "./backgrounds/effects/shader/gradientBars.js";
+export { iridescent } from "./backgrounds/effects/shader/iridescent.js";
+export { triangleGrid } from "./backgrounds/effects/grid/triangleGrid.js";
+export { gridHover } from "./backgrounds/effects/grid/gridHover.js";
+export { morphGrid } from "./backgrounds/effects/grid/morphGrid.js";
+export { layeredGridCards } from "./backgrounds/effects/grid/layeredGridCards.js";
+export { dataGrid } from "./backgrounds/effects/grid/dataGrid.js";
+export { gridHero } from "./backgrounds/effects/grid/gridHero.js";
+export { animatedGrid } from "./backgrounds/effects/grid/animatedGrid.js";
+export { magnetLines } from "./backgrounds/effects/grid/magnetLines.js";
+export { wavyPattern } from "./backgrounds/effects/wave/wavyPattern.js";
+export { moireDots } from "./backgrounds/effects/wave/moireDots.js";
+export { liquidWave } from "./backgrounds/effects/wave/liquidWave.js";
+export { particleOrb } from "./backgrounds/effects/particle/particleOrb.js";
+export { cursorDots } from "./backgrounds/effects/particle/cursorDots.js";
+export { circlesPattern, diamondsPattern, scalesPattern, leatherPattern, strangePattern } from "./backgrounds/effects/pattern/patterns.js";
+export { matrixRain } from "./backgrounds/effects/glitch/matrixRain.js";
+export { asciiArt } from "./backgrounds/effects/glitch/asciiArt.js";
+export { meltyLines } from "./backgrounds/effects/grid/meltyLines.js";
+export { quantumGrid } from "./backgrounds/effects/grid/quantumGrid.js";
+export { neonGridTrail } from "./backgrounds/effects/grid/neonGridTrail.js";
+export { particles } from "./backgrounds/effects/particle/particles.js";
+export { particleHover } from "./backgrounds/effects/particle/particleHover.js";
+export { starfield } from "./backgrounds/effects/particle/starfield.js";
+export { constellation } from "./backgrounds/effects/particle/constellation.js";
+export { fallingParticles } from "./backgrounds/effects/particle/fallingParticles.js";
+export { proximityMask } from "./backgrounds/effects/cursor/proximityMask.js";
+export { flowField } from "./backgrounds/effects/wave/flowField.js";
+export { gooeyBlobs } from "./backgrounds/effects/shader/gooeyBlobs.js";
+export { contourLines } from "./backgrounds/effects/grid/contourLines.js";
+export { geometricVectors } from "./backgrounds/effects/grid/geometricVectors.js";
+export { svgWave } from "./backgrounds/effects/wave/svgWave.js";
+export { svgColorWave } from "./backgrounds/effects/wave/svgColorWave.js";
+export { mountains } from "./backgrounds/effects/wave/mountains.js";
+export { drawingLines } from "./backgrounds/effects/wave/drawingLines.js";
+export { cinematicReveal } from "./backgrounds/effects/scroll/cinematicReveal.js";
+export { scrollColor } from "./backgrounds/effects/scroll/scrollColor.js";
+export { scrollMorph } from "./backgrounds/effects/scroll/scrollMorph.js";
+export { scrollTimeline } from "./backgrounds/effects/scroll/scrollTimeline.js";
+export { parallax } from "./backgrounds/effects/scroll/parallax.js";
+export { videoScrub } from "./backgrounds/effects/scroll/videoScrub.js";
+export { halftone } from "./backgrounds/effects/texture/halftone.js";
+export { vhsStatic } from "./backgrounds/effects/glitch/vhsStatic.js";
+export { ditherWave } from "./backgrounds/effects/glitch/ditherWave.js";
+export { shaderRipples } from "./backgrounds/effects/shader/shaderRipples.js";
+export { shaderLines } from "./backgrounds/effects/shader/shaderLines.js";
+export { waveDistortion } from "./backgrounds/effects/shader/waveDistortion.js";
+export { animatedGradient } from "./backgrounds/effects/shader/animatedGradient.js";
+export { grainGradient } from "./backgrounds/effects/shader/grainGradient.js";
+export { smoothMesh } from "./backgrounds/effects/shader/smoothMesh.js";
+export { plasmaGrid } from "./backgrounds/effects/shader/plasmaGrid.js";
+export { aether } from "./backgrounds/effects/shader/aether.js";
+export { chromaticSine } from "./backgrounds/effects/shader/chromaticSine.js";
+export { liquid } from "./backgrounds/effects/shader/liquid.js";
+export { meshGradient } from "./backgrounds/effects/shader/meshGradient.js";
+export { godRays } from "./backgrounds/effects/shader/godRays.js";
+export { caustics } from "./backgrounds/effects/shader/caustics.js";
+export { liquidSculpture } from "./backgrounds/effects/glass/liquidSculpture.js";
+export { wireframeOcean } from "./backgrounds/effects/wave/wireframeOcean.js";
+export { fluidCursor } from "./backgrounds/effects/cursor/fluidCursor.js";
+export { waterRipple } from "./backgrounds/effects/cursor/waterRipple.js";
+export { image, video } from "./backgrounds/effects/media/media.js";
+// --- text: a heading or paragraph that wears any number of text effects (effects = plain descriptors) ---
+export { Text } from "./text/Text.js";
+export { TEXT_EFFECTS, TEXT_IDS } from "./text/registry.js";
+export { TEXT_GROUPS } from "./text/types.js";
+export { enterRise } from "./text/effects/enter/enterRise.js";
+export { enterWords } from "./text/effects/enter/enterWords.js";
+export { enterMask } from "./text/effects/enter/enterMask.js";
+export { enterBlur } from "./text/effects/enter/enterBlur.js";
+export { enterBounce } from "./text/effects/enter/enterBounce.js";
+export { enterFlip } from "./text/effects/enter/enterFlip.js";
+export { enterPop } from "./text/effects/enter/enterPop.js";
+export { enterRandom } from "./text/effects/enter/enterRandom.js";
+export { enterBox } from "./text/effects/enter/enterBox.js";
+export { enterTracking } from "./text/effects/enter/enterTracking.js";
+export { enterAssemble } from "./text/effects/enter/enterAssemble.js";
+export { enterStamp } from "./text/effects/enter/enterStamp.js";
+export { enterRedact } from "./text/effects/enter/enterRedact.js";
+export { enterSkeleton } from "./text/effects/enter/enterSkeleton.js";
+export { inkShiny } from "./text/effects/ink/inkShiny.js";
+export { inkGradient } from "./text/effects/ink/inkGradient.js";
+export { inkAurora } from "./text/effects/ink/inkAurora.js";
+export { inkVideo } from "./text/effects/ink/inkVideo.js";
+export { inkImage } from "./text/effects/ink/inkImage.js";
+export { inkSparkles } from "./text/effects/ink/inkSparkles.js";
+export { inkLineShadow } from "./text/effects/ink/inkLineShadow.js";
+export { inkNeon } from "./text/effects/ink/inkNeon.js";
+export { inkColourful } from "./text/effects/ink/inkColourful.js";
+export { inkLines } from "./text/effects/ink/inkLines.js";
+export { inkGrain } from "./text/effects/ink/inkGrain.js";
+export { inkSweep } from "./text/effects/ink/inkSweep.js";
+export { inkFoil } from "./text/effects/ink/inkFoil.js";
+export { inkProgress } from "./text/effects/ink/inkProgress.js";
+export { inkDots } from "./text/effects/ink/inkDots.js";
+export { strokeFill } from "./text/effects/stroke/strokeFill.js";
+export { strokeHandwrite } from "./text/effects/stroke/strokeHandwrite.js";
+export { strokeDraw } from "./text/effects/stroke/strokeDraw.js";
+export { strokeGradient } from "./text/effects/stroke/strokeGradient.js";
+export { strokeComic } from "./text/effects/stroke/strokeComic.js";
+export { strokeUnderline } from "./text/effects/stroke/strokeUnderline.js";
+export { strokeNote } from "./text/effects/stroke/strokeNote.js";
+export { decodeHover } from "./text/effects/decode/decodeHover.js";
+export { decodeReveal } from "./text/effects/decode/decodeReveal.js";
+export { decodeBinary } from "./text/effects/decode/decodeBinary.js";
+export { Typewriter } from "./text/type/Typewriter.js";
+export { WordCycle } from "./text/cycle/WordCycle.js";
+export { loopsPaused, setLoopsPaused, onLoopsPaused } from "./text/runtime/loops.js";
+export { usePauseLoops } from "./text/runtime/usePauseLoops.js";
+export { CYCLE_LOOKS } from "./text/cycle/css.js";
+export { NumberRoll } from "./text/number/NumberRoll.js";
+export { scrubHighlight } from "./text/effects/scrub/scrubHighlight.js";
+export { scrubParallax } from "./text/effects/scrub/scrubParallax.js";
+export { scrubPin } from "./text/effects/scrub/scrubPin.js";
+export { scrubMarker } from "./text/effects/scrub/scrubMarker.js";
+export { scrubFloat } from "./text/effects/scrub/scrubFloat.js";
+export { scrubSkew } from "./text/effects/scrub/scrubSkew.js";
+export { scrubCylinder } from "./text/effects/scrub/scrubCylinder.js";
+export { pointerProximity } from "./text/effects/pointer/pointerProximity.js";
+export { pointerPressure } from "./text/effects/pointer/pointerPressure.js";
+export { pointerJello } from "./text/effects/pointer/pointerJello.js";
+export { pointerWave } from "./text/effects/pointer/pointerWave.js";
+export { pointerSpotlight } from "./text/effects/pointer/pointerSpotlight.js";
+export { pointerShadow } from "./text/effects/pointer/pointerShadow.js";
+export { pointerTrail } from "./text/effects/pointer/pointerTrail.js";
+export { pointerRipple } from "./text/effects/pointer/pointerRipple.js";
+export { pointerTilt } from "./text/effects/pointer/pointerTilt.js";
+export { pointerRoll } from "./text/effects/pointer/pointerRoll.js";
+export { warpGlitch } from "./text/effects/warp/warpGlitch.js";
+export { warpSquiggle } from "./text/effects/warp/warpSquiggle.js";
+export { warpWave } from "./text/effects/warp/warpWave.js";
+export { warpGoo } from "./text/effects/warp/warpGoo.js";
+export { warpRgb } from "./text/effects/warp/warpRgb.js";
+export { warpShader } from "./text/effects/warp/warpShader.js";
+export { warpFuzz } from "./text/effects/warp/warpFuzz.js";
+export { warpAscii } from "./text/effects/warp/warpAscii.js";
+export { solidShadow } from "./text/effects/solid/solidShadow.js";
+export { solidLayers } from "./text/effects/solid/solidLayers.js";
+export { solidParticles } from "./text/effects/solid/solidParticles.js";
+export { solidEcho } from "./text/effects/solid/solidEcho.js";
+export { solidFall } from "./text/effects/solid/solidFall.js";
+export { TextPath } from "./text/path/TextPath.js";

package/dist/schema/backgrounds.d.ts

@@ -0,0 +1,2 @@
+import type { Schema } from "./types.js";
+export declare const BACKGROUND_SCHEMAS: Readonly<Record<string, Schema>>;

package/dist/schema/backgrounds.js

@@ -0,0 +1,187 @@
+// The background effects' option schemas, keyed by effect id, in the order of BACKGROUND_EFFECTS, then the
+// image / video slots. Imports only the schema files, which import only types from their effects: this entry
+// carries no effect code. Each schema gets its registry metadata here (label, category, family, tier); a test
+// keeps it equal to BACKGROUND_EFFECTS / BACKGROUND_SLOTS.
+import { FILM_GRAIN_SCHEMA } from "../backgrounds/effects/texture/filmGrain.schema.js";
+import { FOGGY_GLASS_SCHEMA } from "../backgrounds/effects/texture/foggyGlass.schema.js";
+import { FROZEN_GLASS_SCHEMA } from "../backgrounds/effects/texture/frozenGlass.schema.js";
+import { HALFTONE_SCHEMA } from "../backgrounds/effects/texture/halftone.schema.js";
+import { DIGITAL_GLITCH_SCHEMA } from "../backgrounds/effects/glitch/digitalGlitch.schema.js";
+import { VHS_STATIC_SCHEMA } from "../backgrounds/effects/glitch/vhsStatic.schema.js";
+import { DITHER_WAVE_SCHEMA } from "../backgrounds/effects/glitch/ditherWave.schema.js";
+import { RETRO_SCREEN_SCHEMA } from "../backgrounds/effects/glitch/retroScreen.schema.js";
+import { RGB_SHIFT_SCHEMA } from "../backgrounds/effects/glitch/rgbShift.schema.js";
+import { MATRIX_RAIN_SCHEMA } from "../backgrounds/effects/glitch/matrixRain.schema.js";
+import { CRT_SCANLINES_SCHEMA } from "../backgrounds/effects/glitch/crtScanlines.schema.js";
+import { ASCII_ART_SCHEMA } from "../backgrounds/effects/glitch/asciiArt.schema.js";
+import { LIQUID_GLASS_SCHEMA } from "../backgrounds/effects/three/liquidGlass.schema.js";
+import { GLASS_SHAPES_SCHEMA } from "../backgrounds/effects/three/glassShapes.schema.js";
+import { CHROME_SCHEMA } from "../backgrounds/effects/three/chrome.schema.js";
+import { SPECTRAL_GHOST_SCHEMA } from "../backgrounds/effects/three/spectralGhost.schema.js";
+import { ISOMETRIC_LAYERS_SCHEMA } from "../backgrounds/effects/glass/isometricLayers.schema.js";
+import { LIQUID_SCULPTURE_SCHEMA } from "../backgrounds/effects/glass/liquidSculpture.schema.js";
+import { WOVEN_LIGHT_SCHEMA } from "../backgrounds/effects/three/wovenLight.schema.js";
+import { RAINBOW_SCHEMA } from "../backgrounds/effects/shader/rainbow.schema.js";
+import { GRADIENT_BARS_SCHEMA } from "../backgrounds/effects/shader/gradientBars.schema.js";
+import { AURORA_SCHEMA } from "../backgrounds/effects/shader/aurora.schema.js";
+import { IRIDESCENT_SCHEMA } from "../backgrounds/effects/shader/iridescent.schema.js";
+import { GOOEY_BLOBS_SCHEMA } from "../backgrounds/effects/shader/gooeyBlobs.schema.js";
+import { SHADER_RIPPLES_SCHEMA } from "../backgrounds/effects/shader/shaderRipples.schema.js";
+import { SHADER_LINES_SCHEMA } from "../backgrounds/effects/shader/shaderLines.schema.js";
+import { WAVE_DISTORTION_SCHEMA } from "../backgrounds/effects/shader/waveDistortion.schema.js";
+import { ANIMATED_GRADIENT_SCHEMA } from "../backgrounds/effects/shader/animatedGradient.schema.js";
+import { GRAIN_GRADIENT_SCHEMA } from "../backgrounds/effects/shader/grainGradient.schema.js";
+import { SMOOTH_MESH_SCHEMA } from "../backgrounds/effects/shader/smoothMesh.schema.js";
+import { PLASMA_GRID_SCHEMA } from "../backgrounds/effects/shader/plasmaGrid.schema.js";
+import { AETHER_SCHEMA } from "../backgrounds/effects/shader/aether.schema.js";
+import { CHROMATIC_SINE_SCHEMA } from "../backgrounds/effects/shader/chromaticSine.schema.js";
+import { LIQUID_SCHEMA } from "../backgrounds/effects/shader/liquid.schema.js";
+import { MESH_GRADIENT_SCHEMA } from "../backgrounds/effects/shader/meshGradient.schema.js";
+import { GOD_RAYS_SCHEMA } from "../backgrounds/effects/shader/godRays.schema.js";
+import { CAUSTICS_SCHEMA } from "../backgrounds/effects/shader/caustics.schema.js";
+import { GRADIENT_GRID_SCHEMA } from "../backgrounds/effects/grid/gradientGrid.schema.js";
+import { TRIANGLE_GRID_SCHEMA } from "../backgrounds/effects/grid/triangleGrid.schema.js";
+import { GRID_HOVER_SCHEMA } from "../backgrounds/effects/grid/gridHover.schema.js";
+import { FADING_GRID_SCHEMA } from "../backgrounds/effects/grid/fadingGrid.schema.js";
+import { MORPH_GRID_SCHEMA } from "../backgrounds/effects/grid/morphGrid.schema.js";
+import { LAYERED_GRID_CARDS_SCHEMA } from "../backgrounds/effects/grid/layeredGridCards.schema.js";
+import { MELTY_LINES_SCHEMA } from "../backgrounds/effects/grid/meltyLines.schema.js";
+import { DATA_GRID_SCHEMA } from "../backgrounds/effects/grid/dataGrid.schema.js";
+import { GRID_HERO_SCHEMA } from "../backgrounds/effects/grid/gridHero.schema.js";
+import { ANIMATED_GRID_SCHEMA } from "../backgrounds/effects/grid/animatedGrid.schema.js";
+import { QUANTUM_GRID_SCHEMA } from "../backgrounds/effects/grid/quantumGrid.schema.js";
+import { NEON_GRID_TRAIL_SCHEMA } from "../backgrounds/effects/grid/neonGridTrail.schema.js";
+import { DOT_PATTERN_SCHEMA } from "../backgrounds/effects/grid/dotPattern.schema.js";
+import { MAGNET_LINES_SCHEMA } from "../backgrounds/effects/grid/magnetLines.schema.js";
+import { CONTOUR_LINES_SCHEMA } from "../backgrounds/effects/grid/contourLines.schema.js";
+import { GEOMETRIC_VECTORS_SCHEMA } from "../backgrounds/effects/grid/geometricVectors.schema.js";
+import { WAVY_PATTERN_SCHEMA } from "../backgrounds/effects/wave/wavyPattern.schema.js";
+import { RIPPLES_SCHEMA } from "../backgrounds/effects/wave/ripples.schema.js";
+import { MOIRE_DOTS_SCHEMA } from "../backgrounds/effects/wave/moireDots.schema.js";
+import { LIQUID_WAVE_SCHEMA } from "../backgrounds/effects/wave/liquidWave.schema.js";
+import { FLOW_FIELD_SCHEMA } from "../backgrounds/effects/wave/flowField.schema.js";
+import { SVG_WAVE_SCHEMA } from "../backgrounds/effects/wave/svgWave.schema.js";
+import { SVG_COLOR_WAVE_SCHEMA } from "../backgrounds/effects/wave/svgColorWave.schema.js";
+import { MOUNTAINS_SCHEMA } from "../backgrounds/effects/wave/mountains.schema.js";
+import { DRAWING_LINES_SCHEMA } from "../backgrounds/effects/wave/drawingLines.schema.js";
+import { WIREFRAME_OCEAN_SCHEMA } from "../backgrounds/effects/wave/wireframeOcean.schema.js";
+import { PARTICLE_ORB_SCHEMA } from "../backgrounds/effects/particle/particleOrb.schema.js";
+import { PARTICLES_SCHEMA } from "../backgrounds/effects/particle/particles.schema.js";
+import { PARTICLE_HOVER_SCHEMA } from "../backgrounds/effects/particle/particleHover.schema.js";
+import { STARFIELD_SCHEMA } from "../backgrounds/effects/particle/starfield.schema.js";
+import { CONSTELLATION_SCHEMA } from "../backgrounds/effects/particle/constellation.schema.js";
+import { FALLING_PARTICLES_SCHEMA } from "../backgrounds/effects/particle/fallingParticles.schema.js";
+import { CURSOR_DOTS_SCHEMA } from "../backgrounds/effects/particle/cursorDots.schema.js";
+import { BOKEH_SCHEMA } from "../backgrounds/effects/particle/bokeh.schema.js";
+import { METEORS_SCHEMA } from "../backgrounds/effects/particle/meteors.schema.js";
+import { CURSOR_GLOW_SCHEMA } from "../backgrounds/effects/cursor/cursorGlow.schema.js";
+import { PROXIMITY_MASK_SCHEMA } from "../backgrounds/effects/cursor/proximityMask.schema.js";
+import { NEON_TUBES_SCHEMA } from "../backgrounds/effects/three/neonTubes.schema.js";
+import { FLUID_CURSOR_SCHEMA } from "../backgrounds/effects/cursor/fluidCursor.schema.js";
+import { WATER_RIPPLE_SCHEMA } from "../backgrounds/effects/cursor/waterRipple.schema.js";
+import { CINEMATIC_REVEAL_SCHEMA } from "../backgrounds/effects/scroll/cinematicReveal.schema.js";
+import { SCROLL_COLOR_SCHEMA } from "../backgrounds/effects/scroll/scrollColor.schema.js";
+import { SCROLL_MORPH_SCHEMA } from "../backgrounds/effects/scroll/scrollMorph.schema.js";
+import { SCROLL_TIMELINE_SCHEMA } from "../backgrounds/effects/scroll/scrollTimeline.schema.js";
+import { PARALLAX_SCHEMA } from "../backgrounds/effects/scroll/parallax.schema.js";
+import { VIDEO_SCRUB_SCHEMA } from "../backgrounds/effects/scroll/videoScrub.schema.js";
+import { CIRCLES_PATTERN_SCHEMA } from "../backgrounds/effects/pattern/circlesPattern.schema.js";
+import { DIAMONDS_PATTERN_SCHEMA } from "../backgrounds/effects/pattern/diamondsPattern.schema.js";
+import { SCALES_PATTERN_SCHEMA } from "../backgrounds/effects/pattern/scalesPattern.schema.js";
+import { LEATHER_PATTERN_SCHEMA } from "../backgrounds/effects/pattern/leatherPattern.schema.js";
+import { STRANGE_PATTERN_SCHEMA } from "../backgrounds/effects/pattern/strangePattern.schema.js";
+import { IMAGE_SCHEMA } from "../backgrounds/effects/media/image.schema.js";
+import { VIDEO_SCHEMA } from "../backgrounds/effects/media/video.schema.js";
+const LIST = [
+    [FILM_GRAIN_SCHEMA, { "label": "Animated film grain", "category": "texture", "family": "css", "tier": "all" }],
+    [FOGGY_GLASS_SCHEMA, { "label": "Foggy Glass Overlays", "category": "texture", "family": "css", "tier": "mid" }],
+    [FROZEN_GLASS_SCHEMA, { "label": "Stripped Frozen Glass Backgrounds", "category": "texture", "family": "css", "tier": "mid" }],
+    [HALFTONE_SCHEMA, { "label": "Halftone / dot-screen texture", "category": "texture", "family": "webgl", "tier": "mid" }],
+    [DIGITAL_GLITCH_SCHEMA, { "label": "Digital Glitch Effect Backgrounds", "category": "glitch", "family": "css", "tier": "all" }],
+    [VHS_STATIC_SCHEMA, { "label": "Pixel Distort: VHS Glitch Static Backgrounds", "category": "glitch", "family": "webgl", "tier": "mid" }],
+    [DITHER_WAVE_SCHEMA, { "label": "Wave (dithering shader)", "category": "glitch", "family": "webgl", "tier": "mid" }],
+    [RETRO_SCREEN_SCHEMA, { "label": "Retro Anime Screen", "category": "glitch", "family": "css", "tier": "all" }],
+    [RGB_SHIFT_SCHEMA, { "label": "RGB background effect", "category": "glitch", "family": "css", "tier": "all" }],
+    [MATRIX_RAIN_SCHEMA, { "label": "Matrix (digital rain)", "category": "glitch", "family": "canvas", "tier": "all" }],
+    [CRT_SCANLINES_SCHEMA, { "label": "CRT scanlines + vignette", "category": "glitch", "family": "css", "tier": "all" }],
+    [ASCII_ART_SCHEMA, { "label": "ASCII art background", "category": "glitch", "family": "canvas", "tier": "mid" }],
+    [LIQUID_GLASS_SCHEMA, { "label": "Liquid Glass 3D Shapes", "category": "glass", "family": "three", "tier": "high" }],
+    [GLASS_SHAPES_SCHEMA, { "label": "3D Glass Abstract Shapes", "category": "glass", "family": "three", "tier": "high" }],
+    [CHROME_SCHEMA, { "label": "Abstract 3D Chrome Elements", "category": "glass", "family": "three", "tier": "high" }],
+    [SPECTRAL_GHOST_SCHEMA, { "label": "Interactive Spectral 3D Ghost Effect", "category": "glass", "family": "three", "tier": "high" }],
+    [ISOMETRIC_LAYERS_SCHEMA, { "label": "Isometric Floating Layers Diagram", "category": "glass", "family": "css", "tier": "all" }],
+    [LIQUID_SCULPTURE_SCHEMA, { "label": "Liquid Sculpture Hero", "category": "glass", "family": "webgl", "tier": "high" }],
+    [WOVEN_LIGHT_SCHEMA, { "label": "Woven Light Hero", "category": "glass", "family": "three", "tier": "mid" }],
+    [RAINBOW_SCHEMA, { "label": "Pure CSS Rainbow Background", "category": "shader", "family": "css", "tier": "all" }],
+    [GRADIENT_BARS_SCHEMA, { "label": "Gradient Bars Background", "category": "shader", "family": "css", "tier": "all" }],
+    [AURORA_SCHEMA, { "label": "Aurora / northern lights", "category": "shader", "family": "css", "tier": "all" }],
+    [IRIDESCENT_SCHEMA, { "label": "Iridescent / holographic foil", "category": "shader", "family": "css", "tier": "mid" }],
+    [GOOEY_BLOBS_SCHEMA, { "label": "Gooey blobs / metaballs", "category": "shader", "family": "svg", "tier": "mid" }],
+    [SHADER_RIPPLES_SCHEMA, { "label": "Shader Animation", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [SHADER_LINES_SCHEMA, { "label": "Shader Lines", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [WAVE_DISTORTION_SCHEMA, { "label": "WebGL Shader", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [ANIMATED_GRADIENT_SCHEMA, { "label": "Animated Gradient (Componentry)", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [GRAIN_GRADIENT_SCHEMA, { "label": "Grain Gradient Hero Section", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [SMOOTH_MESH_SCHEMA, { "label": "Hero section with smooth bg Shader", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [PLASMA_GRID_SCHEMA, { "label": "Shader Background (plasma grid)", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [AETHER_SCHEMA, { "label": "AetherHero", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [CHROMATIC_SINE_SCHEMA, { "label": "Chromatic Aberration WebGL Sine Wave", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [LIQUID_SCHEMA, { "label": "Liquid Effect Background", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [MESH_GRADIENT_SCHEMA, { "label": "Mesh gradient (Stripe-style)", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [GOD_RAYS_SCHEMA, { "label": "Light beams / god rays", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [CAUSTICS_SCHEMA, { "label": "Caustics (light through water)", "category": "shader", "family": "webgl", "tier": "mid" }],
+    [GRADIENT_GRID_SCHEMA, { "label": "Procedural CSS Gradient Grid Background", "category": "grid", "family": "css", "tier": "all" }],
+    [TRIANGLE_GRID_SCHEMA, { "label": "Geometric Glowing Triangle Mask Grid", "category": "grid", "family": "css", "tier": "all" }],
+    [GRID_HOVER_SCHEMA, { "label": "Grid Lines Hover Effect", "category": "grid", "family": "css", "tier": "all" }],
+    [FADING_GRID_SCHEMA, { "label": "Fading Grid Gradient Background", "category": "grid", "family": "css", "tier": "all" }],
+    [MORPH_GRID_SCHEMA, { "label": "Dynamic CSS Shape Morphing Grid", "category": "grid", "family": "css", "tier": "all" }],
+    [LAYERED_GRID_CARDS_SCHEMA, { "label": "Textured 3D Layered Grid Cards", "category": "grid", "family": "css", "tier": "all" }],
+    [MELTY_LINES_SCHEMA, { "label": "Melty Line Goodness", "category": "grid", "family": "canvas", "tier": "all" }],
+    [DATA_GRID_SCHEMA, { "label": "DataGridHero", "category": "grid", "family": "css", "tier": "all" }],
+    [GRID_HERO_SCHEMA, { "label": "Grid Hero Animated", "category": "grid", "family": "css", "tier": "all" }],
+    [ANIMATED_GRID_SCHEMA, { "label": "Animated Grid", "category": "grid", "family": "css", "tier": "all" }],
+    [QUANTUM_GRID_SCHEMA, { "label": "Quantum Grid Hero", "category": "grid", "family": "canvas", "tier": "mid" }],
+    [NEON_GRID_TRAIL_SCHEMA, { "label": "Interactive Neon Grid Trail", "category": "grid", "family": "canvas", "tier": "all" }],
+    [DOT_PATTERN_SCHEMA, { "label": "Dot pattern / graph paper", "category": "grid", "family": "css", "tier": "all" }],
+    [MAGNET_LINES_SCHEMA, { "label": "Magnet lines", "category": "grid", "family": "css", "tier": "all" }],
+    [CONTOUR_LINES_SCHEMA, { "label": "Contour Mapping (topographic lines)", "category": "grid", "family": "svg", "tier": "all" }],
+    [GEOMETRIC_VECTORS_SCHEMA, { "label": "Abstract Background Geometric Vectors", "category": "grid", "family": "svg", "tier": "all" }],
+    [WAVY_PATTERN_SCHEMA, { "label": "Animated Wavy Pattern", "category": "wave", "family": "css", "tier": "all" }],
+    [RIPPLES_SCHEMA, { "label": "Animated Ripples Background", "category": "wave", "family": "css", "tier": "all" }],
+    [MOIRE_DOTS_SCHEMA, { "label": "Pure CSS Moiré Wave Dots", "category": "wave", "family": "css", "tier": "mid" }],
+    [LIQUID_WAVE_SCHEMA, { "label": "Pure CSS Liquid Wave Illusion", "category": "wave", "family": "css", "tier": "all" }],
+    [FLOW_FIELD_SCHEMA, { "label": "Flow field lines", "category": "wave", "family": "canvas", "tier": "mid" }],
+    [SVG_WAVE_SCHEMA, { "label": "Animated SVG Wave Background", "category": "wave", "family": "svg", "tier": "all" }],
+    [SVG_COLOR_WAVE_SCHEMA, { "label": "Animated SVG Color Wave Effect", "category": "wave", "family": "svg", "tier": "all" }],
+    [MOUNTAINS_SCHEMA, { "label": "Cool Mountain Background", "category": "wave", "family": "svg", "tier": "all" }],
+    [DRAWING_LINES_SCHEMA, { "label": "Animated SVG Background (drawing lines)", "category": "wave", "family": "svg", "tier": "all" }],
+    [WIREFRAME_OCEAN_SCHEMA, { "label": "Wireframe Ocean Vector Waves", "category": "wave", "family": "webgl", "tier": "mid" }],
+    [PARTICLE_ORB_SCHEMA, { "label": "Particle Orb CSS", "category": "particle", "family": "css", "tier": "mid" }],
+    [PARTICLES_SCHEMA, { "label": "Minimalist Canvas Animated Particle", "category": "particle", "family": "canvas", "tier": "all" }],
+    [PARTICLE_HOVER_SCHEMA, { "label": "Particle effect for hero", "category": "particle", "family": "canvas", "tier": "all" }],
+    [STARFIELD_SCHEMA, { "label": "Starfield / hyperspeed warp", "category": "particle", "family": "canvas", "tier": "mid" }],
+    [CONSTELLATION_SCHEMA, { "label": "Constellation network (particles.js style)", "category": "particle", "family": "canvas", "tier": "mid" }],
+    [FALLING_PARTICLES_SCHEMA, { "label": "Snow / rain / confetti", "category": "particle", "family": "canvas", "tier": "all" }],
+    [CURSOR_DOTS_SCHEMA, { "label": "Animated Hero (cursor dot grid)", "category": "particle", "family": "css", "tier": "all" }],
+    [BOKEH_SCHEMA, { "label": "Bokeh lights", "category": "particle", "family": "css", "tier": "all" }],
+    [METEORS_SCHEMA, { "label": "Shooting stars / meteors", "category": "particle", "family": "css", "tier": "all" }],
+    [CURSOR_GLOW_SCHEMA, { "label": "Spotlight / cursor glow", "category": "cursor", "family": "css", "tier": "all" }],
+    [PROXIMITY_MASK_SCHEMA, { "label": "Canvas Proximity Mask Effect", "category": "cursor", "family": "canvas", "tier": "all" }],
+    [NEON_TUBES_SCHEMA, { "label": "Neon 3D Tubes Cursor Trail", "category": "cursor", "family": "three", "tier": "high" }],
+    [FLUID_CURSOR_SCHEMA, { "label": "Fluid simulation / splash cursor", "category": "cursor", "family": "webgl", "tier": "high" }],
+    [WATER_RIPPLE_SCHEMA, { "label": "Water ripple on click", "category": "cursor", "family": "webgl", "tier": "mid" }],
+    [CINEMATIC_REVEAL_SCHEMA, { "label": "Cinematic Hero Section In-View Animation", "category": "scroll", "family": "css", "tier": "all" }],
+    [SCROLL_COLOR_SCHEMA, { "label": "Change background colour with GSAP ScrollTrigger", "category": "scroll", "family": "css", "tier": "all" }],
+    [SCROLL_MORPH_SCHEMA, { "label": "Scroll Morph Hero", "category": "scroll", "family": "css", "tier": "mid" }],
+    [SCROLL_TIMELINE_SCHEMA, { "label": "Native CSS scroll-driven animations", "category": "scroll", "family": "css", "tier": "all" }],
+    [PARALLAX_SCHEMA, { "label": "Parallax layers", "category": "scroll", "family": "css", "tier": "all" }],
+    [VIDEO_SCRUB_SCHEMA, { "label": "Video / image-sequence scrub on scroll", "category": "scroll", "family": "media", "tier": "mid" }],
+    [CIRCLES_PATTERN_SCHEMA, { "label": "CSS-Only Pattern: Circles", "category": "pattern", "family": "css", "tier": "all" }],
+    [DIAMONDS_PATTERN_SCHEMA, { "label": "3D Shadowed Diamonds Tessellated", "category": "pattern", "family": "css", "tier": "all" }],
+    [SCALES_PATTERN_SCHEMA, { "label": "Pure CSS Purple Scales Tessellated Pattern", "category": "pattern", "family": "css", "tier": "all" }],
+    [LEATHER_PATTERN_SCHEMA, { "label": "Pure CSS Leather Sofa Tessellated Pattern", "category": "pattern", "family": "css", "tier": "all" }],
+    [STRANGE_PATTERN_SCHEMA, { "label": "A Strange CSS Only Pattern", "category": "pattern", "family": "css", "tier": "all" }],
+    [IMAGE_SCHEMA, { "label": "Image layer (ripped paper, dust, any texture)", "category": "media", "family": "media", "tier": "all" }],
+    [VIDEO_SCHEMA, { "label": "Video background", "category": "media", "family": "media", "tier": "all" }],
+];
+export const BACKGROUND_SCHEMAS = Object.fromEntries(LIST.map(([schema, meta]) => [schema.id, { ...schema, meta }]));

package/dist/schema/buttons.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from "./types.js";
+/** Every button effect's schema, with its registry metadata, in registry order. Throws if one is missing (caught by the tests). */
+export declare const BUTTON_SCHEMAS: Readonly<Record<string, Schema>>;