npm - littlejsengine - Versions diffs - 1.18.2 → 1.18.7 - Mend

littlejsengine 1.18.2 → 1.18.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (172) hide show

package/COPYRIGHT.txt +38 -0
package/FAQ.md +633 -0
package/LICENSE +5 -27
package/README.md +19 -1
package/dist/littlejs.d.ts +550 -57
package/dist/littlejs.esm.js +2208 -492
package/dist/littlejs.esm.min.js +1 -1
package/dist/littlejs.js +2165 -480
package/dist/littlejs.min.js +1 -1
package/dist/littlejs.release.js +2166 -481
package/package.json +8 -1
package/plugins/box2d.js +36 -9
package/{src/engineMedals.js → plugins/medalSystem.js} +248 -196
package/plugins/pathFinder.js +758 -0
package/plugins/pluginExport.js +26 -0
package/plugins/tween.js +509 -0
package/plugins/tweenSystem.js +509 -0
package/plugins/uiSystem.js +151 -12
package/src/engine.js +9 -145
package/src/engineAudio.js +8 -5
package/src/engineBuild.mjs +4 -1
package/src/engineDebug.js +1 -1
package/src/engineDraw.js +154 -5
package/src/engineExport.js +17 -12
package/src/engineInput.js +27 -1
package/src/engineLogo.js +146 -0
package/src/engineMath.js +10 -3
package/src/engineObject.js +11 -5
package/src/engineParticles.js +6 -3
package/src/engineRelease.js +1 -1
package/src/engineSettings.js +17 -47
package/src/engineUtilities.js +7 -2
package/src/engineWebGL.js +31 -8
package/src/jsconfig.json +3 -1
package/.claude/settings.local.json +0 -7
package/.github/workflows/test.yml +0 -17
package/AI.md +0 -172
package/CLAUDE.md +0 -1
package/examples/box2d/game.js +0 -192
package/examples/box2d/gameObjects.js +0 -564
package/examples/box2d/index.html +0 -9
package/examples/box2d/scenes.js +0 -194
package/examples/box2d/tiles.png +0 -0
package/examples/breakout/game.js +0 -175
package/examples/breakout/gameObjects.js +0 -147
package/examples/breakout/index.html +0 -8
package/examples/breakout/tiles.png +0 -0
package/examples/breakoutTutorial/README.md +0 -521
package/examples/breakoutTutorial/game.js +0 -191
package/examples/breakoutTutorial/images/1.png +0 -0
package/examples/breakoutTutorial/images/10.png +0 -0
package/examples/breakoutTutorial/images/11.png +0 -0
package/examples/breakoutTutorial/images/2.png +0 -0
package/examples/breakoutTutorial/images/3.png +0 -0
package/examples/breakoutTutorial/images/4.png +0 -0
package/examples/breakoutTutorial/images/5.png +0 -0
package/examples/breakoutTutorial/images/6.png +0 -0
package/examples/breakoutTutorial/images/7.png +0 -0
package/examples/breakoutTutorial/images/8.png +0 -0
package/examples/breakoutTutorial/images/9.png +0 -0
package/examples/breakoutTutorial/index.html +0 -8
package/examples/electron/build.mjs +0 -127
package/examples/electron/electron.js +0 -35
package/examples/electron/game.js +0 -54
package/examples/electron/index.html +0 -13
package/examples/electron/package.json +0 -5
package/examples/electron/tiles.png +0 -0
package/examples/empty/game.js +0 -51
package/examples/empty/index.html +0 -5
package/examples/empty/tiles.png +0 -0
package/examples/favicon.png +0 -0
package/examples/games.jpg +0 -0
package/examples/htmlMenu/game.js +0 -82
package/examples/htmlMenu/index.html +0 -45
package/examples/htmlMenu/tiles.png +0 -0
package/examples/index.html +0 -800
package/examples/logo.png +0 -0
package/examples/logo2.png +0 -0
package/examples/module/build.mjs +0 -124
package/examples/module/game.js +0 -132
package/examples/module/index.html +0 -10
package/examples/module/tiles.png +0 -0
package/examples/particles/index.html +0 -426
package/examples/particles/tiles.png +0 -0
package/examples/platformer/data/gameLevelData.tmx +0 -143
package/examples/platformer/data/gameLevelData.tsx +0 -4
package/examples/platformer/game.js +0 -147
package/examples/platformer/gameCharacter.js +0 -309
package/examples/platformer/gameEffects.js +0 -278
package/examples/platformer/gameLevel.js +0 -205
package/examples/platformer/gameLevelData.json +0 -171
package/examples/platformer/gameObjects.js +0 -378
package/examples/platformer/gamePlayer.js +0 -35
package/examples/platformer/index.html +0 -9
package/examples/platformer/tiles.png +0 -0
package/examples/platformer/tilesLevel.png +0 -0
package/examples/puzzle/game.js +0 -331
package/examples/puzzle/index.html +0 -8
package/examples/puzzle/tiles.png +0 -0
package/examples/screenshot.jpg +0 -0
package/examples/shorts/animation.js +0 -18
package/examples/shorts/base.html +0 -54
package/examples/shorts/blending.js +0 -14
package/examples/shorts/box2d.js +0 -51
package/examples/shorts/box2dCar.js +0 -59
package/examples/shorts/box2dPool.js +0 -107
package/examples/shorts/box2dTileLayer.js +0 -48
package/examples/shorts/cameraDrag.js +0 -22
package/examples/shorts/clock.js +0 -21
package/examples/shorts/colors.js +0 -25
package/examples/shorts/debugDraw.js +0 -37
package/examples/shorts/empty.js +0 -30
package/examples/shorts/flappyGame.js +0 -55
package/examples/shorts/fontImage.js +0 -17
package/examples/shorts/fps.js +0 -90
package/examples/shorts/helloWorld.js +0 -11
package/examples/shorts/hillGlideGame.js +0 -63
package/examples/shorts/input.js +0 -64
package/examples/shorts/landerGame.js +0 -57
package/examples/shorts/maze.js +0 -48
package/examples/shorts/medals.js +0 -51
package/examples/shorts/music.js +0 -78
package/examples/shorts/musicPlayer.js +0 -137
package/examples/shorts/nineSlice.js +0 -40
package/examples/shorts/parallax.js +0 -72
package/examples/shorts/particles.js +0 -28
package/examples/shorts/piano.js +0 -44
package/examples/shorts/platformer.js +0 -45
package/examples/shorts/pongGame.js +0 -41
package/examples/shorts/postProcess.js +0 -62
package/examples/shorts/sequencer.js +0 -124
package/examples/shorts/shader.js +0 -29
package/examples/shorts/shapes.js +0 -21
package/examples/shorts/slidingPuzzle.js +0 -52
package/examples/shorts/song.mp3 +0 -0
package/examples/shorts/sound.js +0 -36
package/examples/shorts/spaceGame.js +0 -58
package/examples/shorts/spriteAtlas.js +0 -31
package/examples/shorts/starfield.js +0 -15
package/examples/shorts/texture.js +0 -16
package/examples/shorts/tileLayer.js +0 -48
package/examples/shorts/tileRaycast.js +0 -39
package/examples/shorts/tiles.png +0 -0
package/examples/shorts/tiltedView.js +0 -63
package/examples/shorts/timers.js +0 -53
package/examples/shorts/topDown.js +0 -38
package/examples/shorts/uiSystem.js +0 -61
package/examples/shorts/video.webm +0 -0
package/examples/shorts/videoPlayer.js +0 -34
package/examples/starter/build.bat +0 -7
package/examples/starter/build.mjs +0 -126
package/examples/starter/game.js +0 -137
package/examples/starter/index.html +0 -35
package/examples/starter/tiles.png +0 -0
package/examples/stress/index.html +0 -173
package/examples/style.css +0 -150
package/examples/typescript/build.mjs +0 -60
package/examples/typescript/game.js +0 -100
package/examples/typescript/game.ts +0 -132
package/examples/typescript/index.html +0 -10
package/examples/typescript/tiles.png +0 -0
package/examples/typescript/tsconfig.json +0 -17
package/examples/uiSystem/game.js +0 -139
package/examples/uiSystem/index.html +0 -10
package/examples/uiSystem/tiles.png +0 -0
package/jsconfig.json +0 -12
package/plugins/desktop.ini +0 -2
package/reference.md +0 -447
package/test/math.test.mjs +0 -774
package/test/setup.mjs +0 -22
package/test/smoke.test.mjs +0 -258
package/test/util.test.mjs +0 -80

package/examples/particles/index.html DELETED Viewed

@@ -1,426 +0,0 @@
-<!DOCTYPE html><head>
-<title>LittleJS Particle System Designer</title>
-<meta charset=utf-8>
-<meta name=apple-mobile-web-app-capable content=yes>
-<meta name=mobile-web-app-capable content=yes>
-<link rel=icon type=image/png href=../favicon.png>
-<style>
-input { width:99px; }
-button { margin:1px; }
-body { color:#fff; }
-#div_emitterSettings
-{
-    position:absolute;
-    z-index: 1;
-    height: 100vh;
-    overflow:auto;
-    padding:5px;
-    font-family:sans-serif;
-    column-count: 2;
-    column-fill: auto;
-}
-</style>
-</head><body>
-<div id=div_emitterSettings></div>
-<script type=module>
-// import LittleJS module
-import * as LJS from '../../dist/littlejs.esm.js';
-const {vec2} = LJS;
-'use strict';
-// fix texture bleeding by shrinking tiles slightly
-LJS.setTileDefaultBleed(.5);
-// allow html input controls
-LJS.setInputPreventDefault(false);
-let particleEditor = 0, particleSystem, particleSystemDiv, particleSystemCode;
-let inputExpand;
-let restartTimer = new LJS.Timer();
-const storagePrefix = 'particles_';
-const particleSettings = [];
-function addSetting(name, type, min, max, step, description)
-{
-    particleSettings.push({name, type:type||'number', min, max, step, description});
-}
-addSetting('emitSize',         '', 0, 1e9, .1, 'World space size of the emitter');
-addSetting('emitTime',         '', 0, 1e9, .1, 'How long to stay alive (0 is forever)');
-addSetting('emitRate',         '', 0, 1e9, 1,  'How many particles per second to spawn, does not emit if 0');
-addSetting('emitConeAngle',    '', 0, 1e9, .01,'Local angle to apply velocity to particles from emitter');
-addSetting('tileIndex',        '', -1, 1e9, 1, 'Tile to use to render object (-1 is untextured)');
-addSetting('tileSize',         '', 0, 1e9, 1,  'Size of texture tile in source pixels');
-addSetting('colorStartA',      'color',0,0,0, 'Color at start of life 1');
-addSetting('colorStartA_alpha', 'alpha', 0,    1,   .01, 'Alpha at start of life 1');
-addSetting('colorStartB',      'color',0,0,0, 'Color at start of life 2');
-addSetting('colorStartB_alpha', 'alpha', 0,    1,   .01, 'Alpha at start of life 2');
-addSetting('colorEndA',        'color',0,0,0, 'Color at end of life 1');
-addSetting('colorEndA_alpha',   'alpha', 0,    1,   .01, 'Alpha at end of life 1');
-addSetting('colorEndB',        'color',0,0,0, 'Color at end of life 2');
-addSetting('colorEndB_alpha',   'alpha', 0,    1,   .01, 'Alpha at end of life 2');
-addSetting('particleTime',     '', 0,    1e9, .1, 'How long particles live');
-addSetting('sizeStart',        '', 0,    1e9, .01,'How big are particles at start');
-addSetting('sizeEnd',          '', 0,    1e9, .01,'How big are particles at end');
-addSetting('speed',            '', 0,    1e9, .01,'How fast are particles when spawned');
-addSetting('angleSpeed',       '', 0,    1e9, .01,'How fast are particles rotating');
-addSetting('damping',          '', 0,    1,   .01,'How much to dampen particle speed');
-addSetting('angleDamping',     '', 0,    1,   .01,'How much to dampen particle angular speed');
-addSetting('gravityScale',     '', -1e9, 1e9, .1, 'How much does gravity effect particles');
-addSetting('particleConeAngle','', 0,    1e9, .1, 'Cone for start particle angle');
-addSetting('fadeRate',         '', 0,    1,   .01,'How quickly particles fade in percent of life');
-addSetting('randomness',       '', 0,    1,   .01,'Apply extra randomness percent');
-addSetting('additive',         'checkbox',0,0,0,  'Should particles use additive blend?');
-addSetting('randomColorLinear','checkbox',0,0,0,  'Should color be randomized linearly?');
-function makeEmitter()
-{
-    if (particleSystem)
-        particleSystem.destroy();
-    particleSystem = new LJS.ParticleEmitter(LJS.cameraPos);
-    particleSystem.tileInfo = LJS.tile();
-    particleSystem.emitConeAngle =
-    particleSystem.particleConeAngle = 3.14;
-}
-///////////////////////////////////////////////////////////////////////////////
-function gameInit()
-{
-    makeEmitter();
-    LJS.setGravity(vec2(0,-.01));
-    LJS.setCameraScale(64);
-    const div = div_emitterSettings;
-    const title = document.createElement('span')
-    title.innerText = 'LittleJS Particle Tool';
-    title.style = 'font-size:20px;font-weight:bold;';
-    div.appendChild(title);
-    for (const setting of particleSettings)
-    {
-        // get default value
-        // todo: clean this up
-        let defaultValue = '';
-        {
-            const name = setting.name;
-            const type = setting.type;
-            if (type == 'color')
-            {
-                const color = particleSystem[name];
-                defaultValue = color.toString(false);
-            }
-            else if (type == 'alpha')
-            {
-                if (name == 'colorStartA_alpha')
-                    defaultValue = particleSystem.colorStartA.a;
-                else if (name == 'colorStartB_alpha')
-                    defaultValue = particleSystem.colorStartB.a;
-                else if (name == 'colorEndA_alpha')
-                    defaultValue = particleSystem.colorEndA.a;
-                else if (name == 'colorEndB_alpha')
-                    defaultValue = particleSystem.colorEndB.a;
-            }
-            else if (name == 'tileSize')
-                defaultValue = particleSystem.tileInfo.size.x;
-            else if (type == 'checkbox')
-                defaultValue = particleSystem[name];
-            else
-                defaultValue = particleSystem[name] || '0';
-        }
-        div.appendChild(document.createElement('br'));
-        const input = setting.input = document.createElement('input');
-        const name = setting.name;
-        input.type = setting.type == 'alpha' ? 'number' : setting.type;
-        input.title = setting.description;
-        input.oninput = (e)=> updateParticles(setting.type == 'checkbox');
-        input.onblur = (e)=> updateParticles(1);
-        if (setting.min !== undefined)
-            input.min = setting.min;
-        if (setting.max !== undefined)
-            input.max = setting.max;
-        if (setting.step !== undefined)
-            input.step = setting.step;
-        if (name == 'emitConeAngle' || name  == 'particleConeAngle')
-            particleSystem[name] = 3.14; // simplify pi
-        const inputReset = document.createElement('button');
-        inputReset.innerText = '♻️';
-        inputReset.onclick = (e)=>
-        {
-            setting.type == 'checkbox'?
-                setting.input.checked = defaultValue :
-                setting.input.value = defaultValue;
-            updateParticles(1);
-        }
-        div.appendChild(inputReset);
-        div.appendChild(input);
-        div.appendChild(document.createTextNode(' ' + name));
-    }
-    div.appendChild(document.createElement('br'));
-    div.appendChild(document.createElement('br'));
-    {
-        const button = document.createElement('button')
-        div.appendChild(button);
-        button.innerHTML = 'Copy To Clipboard';
-        button.onclick = (e)=> navigator.clipboard.writeText(particleSystemCode.value);
-    }
-    {
-        const button = document.createElement('button');
-        div.appendChild(button);
-        button.innerHTML = 'Reset';
-        button.onclick = (e)=>
-        {
-            if (!confirm('Reset to default?'))
-                return;
-            makeEmitter();
-            updateInputs();
-            LJS.setCameraScale(50);
-        }
-    }
-    {
-        inputExpand = document.createElement('input');
-        div.appendChild(inputExpand);
-        inputExpand.type = 'checkbox';
-        inputExpand.style.width = 'initial';
-        inputExpand.oninput = (e)=> updateParticles(1);
-        div.appendChild(document.createTextNode(' Expand'));
-    }
-    //div.appendChild(document.createTextNode('JavaScript Code... '));
-    div.appendChild(document.createElement('br'));
-    div.appendChild(particleSystemCode = document.createElement('textarea'));
-    particleSystemCode.style.width = '300px';
-    particleSystemCode.style.height = '100px';
-    particleSystemCode.disabled = true;
-    updateInputs(0);
-    // load from storage
-    for (const setting of particleSettings)
-    {
-        const type = setting.type;
-        const storageName = storagePrefix + setting.name;
-        const savedValue = localStorage[storageName];
-        if (savedValue == undefined)
-            continue;
-        if (type == 'checkbox')
-            setting.input.checked = savedValue == 'true';
-        else
-            setting.input.value = savedValue;
-    }
-    updateParticles();
-    particleSystemCode.value = getCode();
-}
-function updateParticles(shouldUpdateInput)
-{
-    for (const setting of particleSettings)
-    {
-        const input = setting.input;
-        const name = setting.name;
-        const type = setting.type;
-        const inputFloat = parseFloat(input.value) || 0;
-        if (type == 'color')
-        {
-            const color = new LJS.Color().setHex(input.value);
-            particleSystem[name].r = color.r;
-            particleSystem[name].g = color.g;
-            particleSystem[name].b = color.b;
-        }
-        else if (type == 'alpha')
-        {
-            if (name == 'colorStartA_alpha')
-                particleSystem.colorStartA.a = LJS.clamp(inputFloat);
-            else if (name == 'colorStartB_alpha')
-                particleSystem.colorStartB.a = LJS.clamp(inputFloat);
-            else if (name == 'colorEndA_alpha')
-                particleSystem.colorEndA.a   = LJS.clamp(inputFloat);
-            else if (name == 'colorEndB_alpha')
-                particleSystem.colorEndB.a   = LJS.clamp(inputFloat);
-        }
-        else if (name == 'tileIndex')
-        {
-            const tileIndex = parseInt(input.value);
-            particleSystem.tileIndex = tileIndex
-            particleSystem.tileInfo = LJS.tile(tileIndex, particleSystem.tileInfo.size);
-        }
-        else if (name == 'tileSize')
-            particleSystem.tileInfo.size = vec2(parseInt(input.value));
-        else if (type == 'checkbox')
-            particleSystem[name] = input.checked ? 1 : 0;
-        else if (name == 'emitRate')
-            particleSystem[name] = LJS.min(inputFloat,1e4);
-        else
-            particleSystem[name] = LJS.clamp(inputFloat, setting.min, setting.max);
-    }
-    shouldUpdateInput && updateInputs()
-}
-function updateInputs(save=1)
-{
-    for (const setting of particleSettings)
-        updateSetting(setting, save);
-    particleSystemCode.value = getCode();
-}
-function updateSetting(setting, save=1)
-{
-    const input = setting.input;
-    const name = setting.name;
-    const type = setting.type;
-    if (type == 'color')
-    {
-        const color = particleSystem[name];
-        input.value = color.toString(false);
-    }
-    else if (type == 'alpha')
-    {
-        if (name == 'colorStartA_alpha')
-            input.value = particleSystem.colorStartA.a;
-        else if (name == 'colorStartB_alpha')
-            input.value = particleSystem.colorStartB.a;
-        else if (name == 'colorEndA_alpha')
-            input.value = particleSystem.colorEndA.a;
-        else if (name == 'colorEndB_alpha')
-            input.value = particleSystem.colorEndB.a;
-    }
-    else if (name == 'tileSize')
-        input.value = particleSystem.tileInfo.size.x;
-    else if (type == 'checkbox')
-        input.checked = particleSystem[name];
-    else
-        input.value = particleSystem[name] || '0';
-    if (save)
-    {
-        const storageName = storagePrefix + setting.name;
-        localStorage[storageName] = type == 'checkbox' ?
-            input.checked : input.value;
-    }
-}
-function getCode()
-{
-    const expand = inputExpand.checked;
-    let code = '';
-    // limit float precision to prevent long strings
-    const trimFloat = (n, decimals=3)=>
-        Number(Number(n).toFixed(decimals));
-    code = 'new ParticleEmitter(';
-    if (expand)
-        code += '\n  vec2(), 0,\t//position, angle\n';
-    else
-        code += 'vec2(), 0, ';
-    let count = 0;
-    for (const setting of particleSettings)
-    {
-        const name = setting.name;
-        const type = setting.type;
-        let value;
-        if (name == 'tileSize' || type == 'alpha')
-            continue;
-        if (name == 'tileIndex')
-            value = `tile(${particleSystem.tileIndex}, ${particleSystem.tileInfo.size.x})`;
-        else if (type == 'color')
-        {
-            const c = particleSystem[name];
-            value = `new Color(${trimFloat(c.r)}, ${trimFloat(c.g)}, ${trimFloat(c.b)}, ${trimFloat(c.a)})`;
-        }
-        else if (type == 'checkbox')
-            value = particleSystem[name] ? 1 : 0;
-        else
-            value = trimFloat(particleSystem[name]);
-        if (expand)
-            code += '  ';
-        code += value;
-        const isEnd = name == 'randomColorLinear';
-        if (expand)
-        {
-            code += ',\t// ' + name;
-            if (!isEnd)
-                code += '\n';
-        }
-        else if (!isEnd)
-            code += ', ';
-    }
-    if (expand)
-        code += '\n); // particle emitter';
-    else
-        code += ');';
-    return code;
-}
-///////////////////////////////////////////////////////////////////////////////
-function gameUpdate()
-{
-    if (!restartTimer.isSet() && particleSystem.destroyed)
-        restartTimer.set(1);
-    else if (restartTimer.elapsed())
-    {
-        restartTimer.unset()
-        makeEmitter();
-        updateParticles();
-    }
-    if (document.activeElement == document.body)
-    {
-        if (LJS.mouseIsDown(0))
-        {
-            particleSystem.pos = LJS.mousePos;
-            particleSystem.velocity = LJS.mouseDelta.scale(.3*LJS.timeDelta);
-        }
-        else
-        {
-            particleSystem.pos = vec2();
-            particleSystem.velocity = vec2();
-        }
-        if (LJS.mouseWheel)
-        {
-            // zoom camera
-            let cameraScale = LJS.cameraScale;
-            cameraScale -= LJS.sign(LJS.mouseWheel)*cameraScale/5;
-            cameraScale = LJS.clamp(cameraScale, 10, 300);
-            LJS.setCameraScale(cameraScale);
-        }
-    }
-}
-///////////////////////////////////////////////////////////////////////////////
-function gameUpdatePost()
-{
-}
-///////////////////////////////////////////////////////////////////////////////
-function gameRender()
-{
-}
-///////////////////////////////////////////////////////////////////////////////
-function gameRenderPost()
-{
-}
-///////////////////////////////////////////////////////////////////////////////
-// Startup LittleJS Engine
-LJS.engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRenderPost, ['tiles.png']);
-</script>

package/examples/particles/tiles.png DELETED Viewed

Binary file