npm - @underpostnet/cyberia - Versions diffs - 3.3.73 → 3.3.77 - Mend

@underpostnet/cyberia 3.3.73 → 3.3.77

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 (269) hide show

package/.env.example +17 -5
package/.github/workflows/coverall.cyberia.ci.yml +10 -0
package/.github/workflows/docker-image.cyberia-client.ci.yml +1 -1
package/.github/workflows/docker-image.cyberia-client.dev.ci.yml +1 -1
package/.github/workflows/docker-image.cyberia-server.ci.yml +1 -1
package/.github/workflows/docker-image.cyberia-server.dev.ci.yml +1 -1
package/.github/workflows/docker-image.engine-cyberia.ci.yml +1 -1
package/.github/workflows/docker-image.engine-cyberia.dev.ci.yml +1 -1
package/.github/workflows/engine-cyberia.ci.yml +1 -1
package/.github/workflows/publish.cyberia.ci.yml +44 -0
package/AGENTS.md +61 -12
package/CHANGELOG.md +159 -161
package/CLI-HELP.md +20 -13
package/Dockerfile +1 -1
package/Dockerfile.dev +1 -1
package/Dockerfile.test +2 -2
package/README.md +28 -28
package/bin/build.js +96 -21
package/bin/cyberia.js +1247 -1373
package/bin/index.js +1247 -1373
package/compose.env +17 -5
package/conf.js +7 -4
package/deploy/cyberia-client/deploy.sh +10 -11
package/deploy/cyberia-client/package.sh +0 -1
package/deploy/cyberia-client/state.sh +3 -2
package/deploy/cyberia-server/deploy.sh +10 -11
package/deploy/cyberia-server/package.sh +0 -1
package/deploy/cyberia-server/state.sh +3 -2
package/deploy/dd-cyberia/deploy.sh +5 -5
package/deploy/dd-cyberia/init.sh +15 -14
package/deploy/dd-cyberia/package.sh +0 -1
package/deploy/dd-cyberia/state.sh +2 -2
package/deploy/dd-cyberia/sync-deploy.sh +139 -75
package/deploy/lib/config.sh +29 -0
package/deploy/lib/github-actions-logging.sh +92 -76
package/deploy/lib/host.sh +28 -19
package/deploy/lib/state.sh +4 -1
package/deploy/pwa-microservices-template/deploy.sh +10 -8
package/deploy/release/deploy.sh +0 -2
package/deployment.yaml +1 -1
package/docker-compose.yml +23 -17
package/docs/coverage/cyberia/api/cyberia-instance/cyberia-fallback-capture.js.html +1591 -0
package/docs/coverage/cyberia/api/cyberia-instance/index.html +116 -0
package/docs/coverage/cyberia/api/cyberia-server-defaults/cyberia-server-defaults.js.html +4138 -0
package/docs/coverage/cyberia/api/cyberia-server-defaults/index.html +116 -0
package/docs/coverage/cyberia/api/object-layer/index.html +116 -0
package/docs/coverage/cyberia/api/object-layer/object-layer.model.js.html +1393 -0
package/docs/coverage/cyberia/base.css +362 -0
package/docs/coverage/cyberia/block-navigation.js +82 -0
package/docs/coverage/cyberia/favicon.png +0 -0
package/docs/coverage/cyberia/index.html +161 -0
package/docs/coverage/cyberia/prettify.css +101 -0
package/docs/coverage/cyberia/prettify.js +937 -0
package/docs/coverage/cyberia/projects/cyberia/atlas-sprite-sheet-generator.js.html +1315 -0
package/docs/coverage/cyberia/projects/cyberia/index.html +176 -0
package/docs/coverage/cyberia/projects/cyberia/instance-backup.js.html +715 -0
package/docs/coverage/cyberia/projects/cyberia/instance-data.js.html +2182 -0
package/docs/coverage/cyberia/projects/cyberia/shape-generator.js.html +3265 -0
package/docs/coverage/cyberia/projects/cyberia/stat-balance.js.html +328 -0
package/docs/coverage/cyberia/sort-arrow-sprite.png +0 -0
package/docs/coverage/cyberia/sorter.js +205 -0
package/hardhat/package-lock.json +2 -2
package/hardhat/package.json +1 -1
package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml +1 -1
package/manifests/cronjobs/dd-cron/dd-cron-vultr.yaml +1 -1
package/manifests/deployment/dd-cyberia-development/deployment.yaml +1 -1
package/manifests/deployment/dd-default-development/deployment.yaml +2 -2
package/manifests/deployment/mongo-express/deployment.yaml +46 -27
package/manifests/deployment/mongo-express/kustomization.yaml +9 -0
package/manifests/deployment/mongo-express/mongo-express-nodeport.yaml +18 -0
package/manifests/deployment/mongo-express/service.yaml +16 -0
package/manifests/deployment/mongo-express-no-auth/disable-mongodb-auth.yaml +16 -0
package/manifests/deployment/mongo-express-no-auth/kustomization.yaml +16 -0
package/package.json +19 -17
package/scripts/test-monitor.sh +3 -3
package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.controller.js +14 -9
package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.model.js +36 -5
package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.router.js +5 -0
package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.service.js +88 -184
package/src/api/cyberia-action/cyberia-action.router.js +2 -2
package/src/api/cyberia-action/cyberia-action.service.js +3 -4
package/src/api/cyberia-audio/cyberia-audio.controller.js +6 -0
package/src/api/cyberia-audio/cyberia-audio.model.js +61 -0
package/src/api/cyberia-audio/cyberia-audio.router.js +21 -0
package/src/api/cyberia-audio/cyberia-audio.service.js +220 -0
package/src/api/cyberia-client-hints/cyberia-client-hints.controller.js +1 -3
package/src/api/cyberia-client-hints/cyberia-client-hints.model.js +10 -19
package/src/api/cyberia-client-hints/cyberia-client-hints.router.js +12 -34
package/src/api/cyberia-client-hints/cyberia-client-hints.service.js +15 -32
package/src/api/cyberia-dialogue/cyberia-dialogue.model.js +1 -1
package/src/api/cyberia-dialogue/cyberia-dialogue.router.js +1 -1
package/src/api/cyberia-entity/cyberia-entity.model.js +2 -0
package/src/api/cyberia-entity/cyberia-entity.service.js +1 -1
package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.controller.js +8 -2
package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.model.js +31 -20
package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.router.js +16 -1
package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.service.js +466 -3
package/src/api/cyberia-instance/cyberia-fallback-capture.js +87 -51
package/src/api/cyberia-instance/cyberia-fallback-world.js +21 -40
package/src/api/cyberia-instance/cyberia-instance-boot.service.js +5 -5
package/src/api/cyberia-instance/cyberia-instance-items.js +98 -0
package/src/api/cyberia-instance/cyberia-instance-map.service.js +34 -141
package/src/api/cyberia-instance/cyberia-instance.controller.js +1 -4
package/src/api/cyberia-instance/cyberia-instance.model.js +0 -14
package/src/api/cyberia-instance/cyberia-instance.router.js +3 -16
package/src/api/cyberia-instance/cyberia-instance.service.js +3 -43
package/src/api/cyberia-instance/cyberia-world-generator.js +8 -13
package/src/api/cyberia-instance-conf/cyberia-instance-conf.model.js +49 -75
package/src/api/cyberia-instance-conf/cyberia-instance-conf.service.js +74 -1
package/src/api/cyberia-map/cyberia-map.service.js +6 -2
package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.controller.js +31 -0
package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.model.js +56 -0
package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.router.js +33 -0
package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.service.js +189 -0
package/src/api/cyberia-quest/cyberia-quest.router.js +3 -3
package/src/api/cyberia-quest/cyberia-quest.service.js +3 -3
package/src/api/cyberia-quest-progress/cyberia-quest-progress.model.js +1 -1
package/src/api/cyberia-server-defaults/cyberia-server-defaults.js +403 -188
package/src/api/cyberia-skill/cyberia-skill.model.js +6 -6
package/src/api/file/file.ref.js +153 -0
package/src/api/file/file.ref.json +11 -2
package/src/api/object-layer/object-layer.model.js +47 -12
package/src/api/object-layer/object-layer.router.js +10 -3
package/src/api/object-layer/object-layer.service.js +113 -120
package/src/cli/app.js +12 -1
package/src/cli/client.js +2 -2
package/src/cli/cluster.js +80 -18
package/src/cli/deploy.js +215 -34
package/src/cli/docker-compose.js +1 -1
package/src/cli/fs-selection.js +115 -0
package/src/cli/fs.js +158 -342
package/src/cli/index.js +22 -10
package/src/cli/release.js +3 -1
package/src/cli/repository.js +35 -9
package/src/cli/run.js +80 -199
package/src/cli/test.js +4 -0
package/src/cli/wireguard.js +32 -31
package/src/client/components/core/Badge.js +0 -1
package/src/client/components/core/CssCore.js +8 -1
package/src/client/components/core/Docs.js +77 -100
package/src/client/components/core/Modal.js +77 -23
package/src/client/components/core/ToolTip.js +15 -0
package/src/client/components/cryptokoyn/AppShellCryptokoyn.js +0 -2
package/src/client/components/cyberia/ActionEngineCyberia.js +12 -36
package/src/client/components/cyberia/EntityEngineCyberia.js +492 -121
package/src/client/components/cyberia/InstanceEngineCyberia.js +129 -160
package/src/client/components/cyberia/InstanceSelectionView.js +7 -1
package/src/client/components/cyberia/MapEngineCyberia.js +175 -69
package/src/client/components/cyberia/ObjectLayerEngine.js +1011 -97
package/src/client/components/cyberia/ObjectLayerEngineModal.js +81 -155
package/src/client/components/cyberia/ObjectLayerEngineViewer.js +113 -98
package/src/client/components/cyberia/SharedDefaultsCyberia.js +215 -56
package/src/client/components/cyberia-portal/AppShellCyberiaPortal.js +0 -34
package/src/client/components/cyberia-portal/CssCyberiaPortal.js +1 -1
package/src/client/components/cyberia-portal/MainBodyCyberiaPortal.js +712 -76
package/src/client/components/cyberia-portal/RouterCyberiaPortal.js +0 -4
package/src/client/components/cyberia-portal/TranslateCyberiaPortal.js +0 -4
package/src/client/components/default/AppShellDefault.js +1 -4
package/src/client/components/itemledger/AppShellItemledger.js +0 -2
package/src/client/components/underpost/AppShellUnderpost.js +1 -1
package/src/client/public/cyberia-docs/ARCHITECTURE.md +15 -15
package/src/client/public/cyberia-docs/CYBERIA-CLI.md +280 -24
package/src/client/public/cyberia-docs/CYBERIA-CLIENT.md +51 -29
package/src/client/public/cyberia-docs/CYBERIA-SAGA.md +52 -53
package/src/client/public/cyberia-docs/CYBERIA-SERVER.md +16 -11
package/src/client/public/cyberia-docs/CYBERIA.md +28 -28
package/src/client/public/cyberia-docs/ENTITY-PROFILE.md +11 -5
package/src/client/public/cyberia-docs/ROADMAP.md +1 -1
package/src/client/public/cyberia-docs/STATS-PROGRESSION.md +217 -0
package/src/client/public/cyberia-docs/WHITE-PAPER.md +20 -12
package/src/client/services/cyberia-audio/cyberia-audio.service.js +99 -0
package/src/client/services/cyberia-entity-type-default/cyberia-entity-type-default.service.js +38 -0
package/src/client/services/cyberia-instance/cyberia-instance.management.js +5 -4
package/src/client/services/cyberia-instance/cyberia-instance.service.js +0 -40
package/src/client/services/cyberia-map/cyberia-map.management.js +5 -4
package/src/client/services/cyberia-map-audio-conf/cyberia-map-audio-conf.service.js +138 -0
package/src/client/services/object-layer/object-layer.management.js +6 -10
package/src/client/services/object-layer/object-layer.service.js +3 -1
package/src/client/ssr/views/Cyberia404.js +3 -3
package/src/client-builder/client-build-docs.js +52 -52
package/src/client-builder/client-build.js +67 -44
package/src/client-builder/client-bundle.js +347 -0
package/src/db/mongo/MongoExpress.js +187 -0
package/src/grpc/cyberia/grpc-server.js +5 -7
package/src/index.js +1 -1
package/src/projects/cyberia/atlas-sprite-sheet-generator.js +143 -146
package/src/projects/cyberia/atlas-sprite-sheet-store.js +391 -0
package/src/projects/cyberia/besu-genesis-generator.js +5 -14
package/src/projects/cyberia/boot-contract-fixtures.js +32 -0
package/src/projects/cyberia/catalog-cyberia.js +3 -2
package/src/projects/cyberia/gemini-client.js +3 -3
package/src/projects/cyberia/generate-saga.js +4 -11
package/src/projects/cyberia/hot-reload-trigger.js +17 -28
package/src/projects/cyberia/instance-backup.js +210 -0
package/src/projects/cyberia/instance-data.js +177 -257
package/src/projects/cyberia/map-preview-generator.js +32 -68
package/src/projects/cyberia/object-layer.js +152 -319
package/src/projects/cyberia/seed-audio.js +139 -0
package/src/projects/cyberia/semantic-layer-generator-skin.js +2 -8
package/src/projects/cyberia/semantic-layer-generator.js +2 -18
package/src/projects/cyberia/stat-balance.js +81 -0
package/src/projects/cyberia/stat-commands.js +23 -0
package/src/projects/cyberia/stat-contract-generator.js +101 -0
package/src/runtime/cyberia-client/Dockerfile +8 -4
package/src/runtime/cyberia-client/Dockerfile.dev +5 -2
package/src/runtime/cyberia-server/Dockerfile +9 -2
package/src/runtime/cyberia-server/Dockerfile.dev +8 -1
package/src/runtime/engine-cyberia/Dockerfile +1 -1
package/src/runtime/engine-cyberia/Dockerfile.dev +1 -1
package/src/runtime/engine-cyberia/Dockerfile.test +2 -2
package/src/runtime/engine-cyberia/compose.env +17 -5
package/src/runtime/engine-cyberia/docker-compose.yml +23 -17
package/src/server/build/coverage.js +113 -42
package/src/server/build/package.js +55 -12
package/src/server/build/testing.js +59 -9
package/src/server/network/middlewares.js +8 -2
package/src/server/network/underpost-gateway.js +113 -14
package/src/server/ops/logger.js +70 -35
package/src/server/runtime/conf.js +40 -9
package/src/server/runtime/start.js +11 -2
package/src/server/storage/data-query.js +16 -0
package/src/server/storage/downloader.js +62 -14
package/src/server/storage/zip.js +153 -0
package/test/integration/app/cyberia/atlas-sprite-sheet-store.test.js +402 -0
package/test/integration/app/cyberia/atlas-sprite-sheet.test.js +86 -0
package/test/integration/app/cyberia/cyberia-cli-plain-reads.test.js +34 -0
package/test/integration/app/cyberia/cyberia-entity-type-default.test.js +842 -0
package/test/integration/app/cyberia/cyberia-instance-conf-coerce.test.js +53 -0
package/test/integration/app/cyberia/cyberia-instance-conf-defaults.test.js +16 -22
package/test/integration/app/cyberia/cyberia-instance-items.test.js +90 -0
package/test/integration/app/cyberia/cyberia-load.test.js +6 -7
package/test/integration/app/cyberia/cyberia-map-audio-conf.test.js +256 -0
package/test/integration/app/cyberia/cyberia-stats.test.js +150 -0
package/test/integration/app/cyberia/fallback-world-capture.test.js +87 -2
package/test/integration/app/cyberia/object-layer-item-selection.test.js +56 -0
package/test/integration/app/cyberia/object-layer-natural-key.test.js +32 -0
package/test/integration/app/cyberia/seed-audio.test.js +275 -0
package/test/integration/infra/2-network/wireguard-cli.test.js +33 -9
package/test/integration/infra/2-network/wireguard-edge.test.js +58 -18
package/test/integration/infra/3-cluster/mongo-express-deploy.test.js +156 -0
package/test/integration/infra/4-ingress/api-cross-origin.test.js +79 -0
package/test/integration/infra/4-ingress/underpost-ingress.test.js +1 -1
package/test/unit/catalog.test.js +13 -2
package/test/unit/client-build-docs.test.js +97 -70
package/test/unit/client-bundle.test.js +313 -0
package/test/unit/conf-resolution.test.js +58 -7
package/test/unit/coverage-artifact.test.js +120 -29
package/test/unit/cyberia/instance-backup.test.js +183 -0
package/test/unit/cyberia/instance-data.test.js +314 -0
package/test/unit/cyberia/instance-object-layer-items.test.js +46 -0
package/test/unit/cyberia/publish-workflow.test.js +22 -0
package/test/unit/cyberia/stat-balance.test.js +69 -0
package/test/unit/deploy-legacy-gateway-sweep.test.js +63 -0
package/test/unit/deploy-log-table.test.js +76 -5
package/test/unit/downloader-integrity.test.js +98 -0
package/test/unit/file-reference-registry.test.js +141 -0
package/test/unit/fs-storage-paths.test.js +596 -0
package/test/unit/gateway-pod-fetch.test.js +95 -0
package/test/unit/letsencrypt-issuer.test.js +101 -0
package/test/unit/logger-redaction.test.js +29 -0
package/test/unit/package.test.js +70 -16
package/test/unit/prepare-host.test.js +84 -1
package/test/unit/release-bump.test.js +3 -1
package/test/unit/start-options.test.js +12 -0
package/test/unit/test-tiers.test.js +27 -0
package/test/unit/zip-archive.test.js +142 -0
package/vitest.config.js +11 -3
package/src/api/cyberia-instance/cyberia-fallback-default-items.js +0 -63
package/src/client/components/cyberia/FallbackWorldEngineCyberia.js +0 -368

package/docs/coverage/cyberia/projects/cyberia/atlas-sprite-sheet-generator.js.html ADDED Viewed

@@ -0,0 +1,1315 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for projects/cyberia/atlas-sprite-sheet-generator.js</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> / <a href="index.html">projects/cyberia</a> atlas-sprite-sheet-generator.js</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">91.91% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>125/136</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">84.81% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>67/79</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>12/12</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">94.16% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>113/120</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a>
+<a name='L39'></a><a href='#L39'>39</a>
+<a name='L40'></a><a href='#L40'>40</a>
+<a name='L41'></a><a href='#L41'>41</a>
+<a name='L42'></a><a href='#L42'>42</a>
+<a name='L43'></a><a href='#L43'>43</a>
+<a name='L44'></a><a href='#L44'>44</a>
+<a name='L45'></a><a href='#L45'>45</a>
+<a name='L46'></a><a href='#L46'>46</a>
+<a name='L47'></a><a href='#L47'>47</a>
+<a name='L48'></a><a href='#L48'>48</a>
+<a name='L49'></a><a href='#L49'>49</a>
+<a name='L50'></a><a href='#L50'>50</a>
+<a name='L51'></a><a href='#L51'>51</a>
+<a name='L52'></a><a href='#L52'>52</a>
+<a name='L53'></a><a href='#L53'>53</a>
+<a name='L54'></a><a href='#L54'>54</a>
+<a name='L55'></a><a href='#L55'>55</a>
+<a name='L56'></a><a href='#L56'>56</a>
+<a name='L57'></a><a href='#L57'>57</a>
+<a name='L58'></a><a href='#L58'>58</a>
+<a name='L59'></a><a href='#L59'>59</a>
+<a name='L60'></a><a href='#L60'>60</a>
+<a name='L61'></a><a href='#L61'>61</a>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a>
+<a name='L70'></a><a href='#L70'>70</a>
+<a name='L71'></a><a href='#L71'>71</a>
+<a name='L72'></a><a href='#L72'>72</a>
+<a name='L73'></a><a href='#L73'>73</a>
+<a name='L74'></a><a href='#L74'>74</a>
+<a name='L75'></a><a href='#L75'>75</a>
+<a name='L76'></a><a href='#L76'>76</a>
+<a name='L77'></a><a href='#L77'>77</a>
+<a name='L78'></a><a href='#L78'>78</a>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a>
+<a name='L81'></a><a href='#L81'>81</a>
+<a name='L82'></a><a href='#L82'>82</a>
+<a name='L83'></a><a href='#L83'>83</a>
+<a name='L84'></a><a href='#L84'>84</a>
+<a name='L85'></a><a href='#L85'>85</a>
+<a name='L86'></a><a href='#L86'>86</a>
+<a name='L87'></a><a href='#L87'>87</a>
+<a name='L88'></a><a href='#L88'>88</a>
+<a name='L89'></a><a href='#L89'>89</a>
+<a name='L90'></a><a href='#L90'>90</a>
+<a name='L91'></a><a href='#L91'>91</a>
+<a name='L92'></a><a href='#L92'>92</a>
+<a name='L93'></a><a href='#L93'>93</a>
+<a name='L94'></a><a href='#L94'>94</a>
+<a name='L95'></a><a href='#L95'>95</a>
+<a name='L96'></a><a href='#L96'>96</a>
+<a name='L97'></a><a href='#L97'>97</a>
+<a name='L98'></a><a href='#L98'>98</a>
+<a name='L99'></a><a href='#L99'>99</a>
+<a name='L100'></a><a href='#L100'>100</a>
+<a name='L101'></a><a href='#L101'>101</a>
+<a name='L102'></a><a href='#L102'>102</a>
+<a name='L103'></a><a href='#L103'>103</a>
+<a name='L104'></a><a href='#L104'>104</a>
+<a name='L105'></a><a href='#L105'>105</a>
+<a name='L106'></a><a href='#L106'>106</a>
+<a name='L107'></a><a href='#L107'>107</a>
+<a name='L108'></a><a href='#L108'>108</a>
+<a name='L109'></a><a href='#L109'>109</a>
+<a name='L110'></a><a href='#L110'>110</a>
+<a name='L111'></a><a href='#L111'>111</a>
+<a name='L112'></a><a href='#L112'>112</a>
+<a name='L113'></a><a href='#L113'>113</a>
+<a name='L114'></a><a href='#L114'>114</a>
+<a name='L115'></a><a href='#L115'>115</a>
+<a name='L116'></a><a href='#L116'>116</a>
+<a name='L117'></a><a href='#L117'>117</a>
+<a name='L118'></a><a href='#L118'>118</a>
+<a name='L119'></a><a href='#L119'>119</a>
+<a name='L120'></a><a href='#L120'>120</a>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a>
+<a name='L123'></a><a href='#L123'>123</a>
+<a name='L124'></a><a href='#L124'>124</a>
+<a name='L125'></a><a href='#L125'>125</a>
+<a name='L126'></a><a href='#L126'>126</a>
+<a name='L127'></a><a href='#L127'>127</a>
+<a name='L128'></a><a href='#L128'>128</a>
+<a name='L129'></a><a href='#L129'>129</a>
+<a name='L130'></a><a href='#L130'>130</a>
+<a name='L131'></a><a href='#L131'>131</a>
+<a name='L132'></a><a href='#L132'>132</a>
+<a name='L133'></a><a href='#L133'>133</a>
+<a name='L134'></a><a href='#L134'>134</a>
+<a name='L135'></a><a href='#L135'>135</a>
+<a name='L136'></a><a href='#L136'>136</a>
+<a name='L137'></a><a href='#L137'>137</a>
+<a name='L138'></a><a href='#L138'>138</a>
+<a name='L139'></a><a href='#L139'>139</a>
+<a name='L140'></a><a href='#L140'>140</a>
+<a name='L141'></a><a href='#L141'>141</a>
+<a name='L142'></a><a href='#L142'>142</a>
+<a name='L143'></a><a href='#L143'>143</a>
+<a name='L144'></a><a href='#L144'>144</a>
+<a name='L145'></a><a href='#L145'>145</a>
+<a name='L146'></a><a href='#L146'>146</a>
+<a name='L147'></a><a href='#L147'>147</a>
+<a name='L148'></a><a href='#L148'>148</a>
+<a name='L149'></a><a href='#L149'>149</a>
+<a name='L150'></a><a href='#L150'>150</a>
+<a name='L151'></a><a href='#L151'>151</a>
+<a name='L152'></a><a href='#L152'>152</a>
+<a name='L153'></a><a href='#L153'>153</a>
+<a name='L154'></a><a href='#L154'>154</a>
+<a name='L155'></a><a href='#L155'>155</a>
+<a name='L156'></a><a href='#L156'>156</a>
+<a name='L157'></a><a href='#L157'>157</a>
+<a name='L158'></a><a href='#L158'>158</a>
+<a name='L159'></a><a href='#L159'>159</a>
+<a name='L160'></a><a href='#L160'>160</a>
+<a name='L161'></a><a href='#L161'>161</a>
+<a name='L162'></a><a href='#L162'>162</a>
+<a name='L163'></a><a href='#L163'>163</a>
+<a name='L164'></a><a href='#L164'>164</a>
+<a name='L165'></a><a href='#L165'>165</a>
+<a name='L166'></a><a href='#L166'>166</a>
+<a name='L167'></a><a href='#L167'>167</a>
+<a name='L168'></a><a href='#L168'>168</a>
+<a name='L169'></a><a href='#L169'>169</a>
+<a name='L170'></a><a href='#L170'>170</a>
+<a name='L171'></a><a href='#L171'>171</a>
+<a name='L172'></a><a href='#L172'>172</a>
+<a name='L173'></a><a href='#L173'>173</a>
+<a name='L174'></a><a href='#L174'>174</a>
+<a name='L175'></a><a href='#L175'>175</a>
+<a name='L176'></a><a href='#L176'>176</a>
+<a name='L177'></a><a href='#L177'>177</a>
+<a name='L178'></a><a href='#L178'>178</a>
+<a name='L179'></a><a href='#L179'>179</a>
+<a name='L180'></a><a href='#L180'>180</a>
+<a name='L181'></a><a href='#L181'>181</a>
+<a name='L182'></a><a href='#L182'>182</a>
+<a name='L183'></a><a href='#L183'>183</a>
+<a name='L184'></a><a href='#L184'>184</a>
+<a name='L185'></a><a href='#L185'>185</a>
+<a name='L186'></a><a href='#L186'>186</a>
+<a name='L187'></a><a href='#L187'>187</a>
+<a name='L188'></a><a href='#L188'>188</a>
+<a name='L189'></a><a href='#L189'>189</a>
+<a name='L190'></a><a href='#L190'>190</a>
+<a name='L191'></a><a href='#L191'>191</a>
+<a name='L192'></a><a href='#L192'>192</a>
+<a name='L193'></a><a href='#L193'>193</a>
+<a name='L194'></a><a href='#L194'>194</a>
+<a name='L195'></a><a href='#L195'>195</a>
+<a name='L196'></a><a href='#L196'>196</a>
+<a name='L197'></a><a href='#L197'>197</a>
+<a name='L198'></a><a href='#L198'>198</a>
+<a name='L199'></a><a href='#L199'>199</a>
+<a name='L200'></a><a href='#L200'>200</a>
+<a name='L201'></a><a href='#L201'>201</a>
+<a name='L202'></a><a href='#L202'>202</a>
+<a name='L203'></a><a href='#L203'>203</a>
+<a name='L204'></a><a href='#L204'>204</a>
+<a name='L205'></a><a href='#L205'>205</a>
+<a name='L206'></a><a href='#L206'>206</a>
+<a name='L207'></a><a href='#L207'>207</a>
+<a name='L208'></a><a href='#L208'>208</a>
+<a name='L209'></a><a href='#L209'>209</a>
+<a name='L210'></a><a href='#L210'>210</a>
+<a name='L211'></a><a href='#L211'>211</a>
+<a name='L212'></a><a href='#L212'>212</a>
+<a name='L213'></a><a href='#L213'>213</a>
+<a name='L214'></a><a href='#L214'>214</a>
+<a name='L215'></a><a href='#L215'>215</a>
+<a name='L216'></a><a href='#L216'>216</a>
+<a name='L217'></a><a href='#L217'>217</a>
+<a name='L218'></a><a href='#L218'>218</a>
+<a name='L219'></a><a href='#L219'>219</a>
+<a name='L220'></a><a href='#L220'>220</a>
+<a name='L221'></a><a href='#L221'>221</a>
+<a name='L222'></a><a href='#L222'>222</a>
+<a name='L223'></a><a href='#L223'>223</a>
+<a name='L224'></a><a href='#L224'>224</a>
+<a name='L225'></a><a href='#L225'>225</a>
+<a name='L226'></a><a href='#L226'>226</a>
+<a name='L227'></a><a href='#L227'>227</a>
+<a name='L228'></a><a href='#L228'>228</a>
+<a name='L229'></a><a href='#L229'>229</a>
+<a name='L230'></a><a href='#L230'>230</a>
+<a name='L231'></a><a href='#L231'>231</a>
+<a name='L232'></a><a href='#L232'>232</a>
+<a name='L233'></a><a href='#L233'>233</a>
+<a name='L234'></a><a href='#L234'>234</a>
+<a name='L235'></a><a href='#L235'>235</a>
+<a name='L236'></a><a href='#L236'>236</a>
+<a name='L237'></a><a href='#L237'>237</a>
+<a name='L238'></a><a href='#L238'>238</a>
+<a name='L239'></a><a href='#L239'>239</a>
+<a name='L240'></a><a href='#L240'>240</a>
+<a name='L241'></a><a href='#L241'>241</a>
+<a name='L242'></a><a href='#L242'>242</a>
+<a name='L243'></a><a href='#L243'>243</a>
+<a name='L244'></a><a href='#L244'>244</a>
+<a name='L245'></a><a href='#L245'>245</a>
+<a name='L246'></a><a href='#L246'>246</a>
+<a name='L247'></a><a href='#L247'>247</a>
+<a name='L248'></a><a href='#L248'>248</a>
+<a name='L249'></a><a href='#L249'>249</a>
+<a name='L250'></a><a href='#L250'>250</a>
+<a name='L251'></a><a href='#L251'>251</a>
+<a name='L252'></a><a href='#L252'>252</a>
+<a name='L253'></a><a href='#L253'>253</a>
+<a name='L254'></a><a href='#L254'>254</a>
+<a name='L255'></a><a href='#L255'>255</a>
+<a name='L256'></a><a href='#L256'>256</a>
+<a name='L257'></a><a href='#L257'>257</a>
+<a name='L258'></a><a href='#L258'>258</a>
+<a name='L259'></a><a href='#L259'>259</a>
+<a name='L260'></a><a href='#L260'>260</a>
+<a name='L261'></a><a href='#L261'>261</a>
+<a name='L262'></a><a href='#L262'>262</a>
+<a name='L263'></a><a href='#L263'>263</a>
+<a name='L264'></a><a href='#L264'>264</a>
+<a name='L265'></a><a href='#L265'>265</a>
+<a name='L266'></a><a href='#L266'>266</a>
+<a name='L267'></a><a href='#L267'>267</a>
+<a name='L268'></a><a href='#L268'>268</a>
+<a name='L269'></a><a href='#L269'>269</a>
+<a name='L270'></a><a href='#L270'>270</a>
+<a name='L271'></a><a href='#L271'>271</a>
+<a name='L272'></a><a href='#L272'>272</a>
+<a name='L273'></a><a href='#L273'>273</a>
+<a name='L274'></a><a href='#L274'>274</a>
+<a name='L275'></a><a href='#L275'>275</a>
+<a name='L276'></a><a href='#L276'>276</a>
+<a name='L277'></a><a href='#L277'>277</a>
+<a name='L278'></a><a href='#L278'>278</a>
+<a name='L279'></a><a href='#L279'>279</a>
+<a name='L280'></a><a href='#L280'>280</a>
+<a name='L281'></a><a href='#L281'>281</a>
+<a name='L282'></a><a href='#L282'>282</a>
+<a name='L283'></a><a href='#L283'>283</a>
+<a name='L284'></a><a href='#L284'>284</a>
+<a name='L285'></a><a href='#L285'>285</a>
+<a name='L286'></a><a href='#L286'>286</a>
+<a name='L287'></a><a href='#L287'>287</a>
+<a name='L288'></a><a href='#L288'>288</a>
+<a name='L289'></a><a href='#L289'>289</a>
+<a name='L290'></a><a href='#L290'>290</a>
+<a name='L291'></a><a href='#L291'>291</a>
+<a name='L292'></a><a href='#L292'>292</a>
+<a name='L293'></a><a href='#L293'>293</a>
+<a name='L294'></a><a href='#L294'>294</a>
+<a name='L295'></a><a href='#L295'>295</a>
+<a name='L296'></a><a href='#L296'>296</a>
+<a name='L297'></a><a href='#L297'>297</a>
+<a name='L298'></a><a href='#L298'>298</a>
+<a name='L299'></a><a href='#L299'>299</a>
+<a name='L300'></a><a href='#L300'>300</a>
+<a name='L301'></a><a href='#L301'>301</a>
+<a name='L302'></a><a href='#L302'>302</a>
+<a name='L303'></a><a href='#L303'>303</a>
+<a name='L304'></a><a href='#L304'>304</a>
+<a name='L305'></a><a href='#L305'>305</a>
+<a name='L306'></a><a href='#L306'>306</a>
+<a name='L307'></a><a href='#L307'>307</a>
+<a name='L308'></a><a href='#L308'>308</a>
+<a name='L309'></a><a href='#L309'>309</a>
+<a name='L310'></a><a href='#L310'>310</a>
+<a name='L311'></a><a href='#L311'>311</a>
+<a name='L312'></a><a href='#L312'>312</a>
+<a name='L313'></a><a href='#L313'>313</a>
+<a name='L314'></a><a href='#L314'>314</a>
+<a name='L315'></a><a href='#L315'>315</a>
+<a name='L316'></a><a href='#L316'>316</a>
+<a name='L317'></a><a href='#L317'>317</a>
+<a name='L318'></a><a href='#L318'>318</a>
+<a name='L319'></a><a href='#L319'>319</a>
+<a name='L320'></a><a href='#L320'>320</a>
+<a name='L321'></a><a href='#L321'>321</a>
+<a name='L322'></a><a href='#L322'>322</a>
+<a name='L323'></a><a href='#L323'>323</a>
+<a name='L324'></a><a href='#L324'>324</a>
+<a name='L325'></a><a href='#L325'>325</a>
+<a name='L326'></a><a href='#L326'>326</a>
+<a name='L327'></a><a href='#L327'>327</a>
+<a name='L328'></a><a href='#L328'>328</a>
+<a name='L329'></a><a href='#L329'>329</a>
+<a name='L330'></a><a href='#L330'>330</a>
+<a name='L331'></a><a href='#L331'>331</a>
+<a name='L332'></a><a href='#L332'>332</a>
+<a name='L333'></a><a href='#L333'>333</a>
+<a name='L334'></a><a href='#L334'>334</a>
+<a name='L335'></a><a href='#L335'>335</a>
+<a name='L336'></a><a href='#L336'>336</a>
+<a name='L337'></a><a href='#L337'>337</a>
+<a name='L338'></a><a href='#L338'>338</a>
+<a name='L339'></a><a href='#L339'>339</a>
+<a name='L340'></a><a href='#L340'>340</a>
+<a name='L341'></a><a href='#L341'>341</a>
+<a name='L342'></a><a href='#L342'>342</a>
+<a name='L343'></a><a href='#L343'>343</a>
+<a name='L344'></a><a href='#L344'>344</a>
+<a name='L345'></a><a href='#L345'>345</a>
+<a name='L346'></a><a href='#L346'>346</a>
+<a name='L347'></a><a href='#L347'>347</a>
+<a name='L348'></a><a href='#L348'>348</a>
+<a name='L349'></a><a href='#L349'>349</a>
+<a name='L350'></a><a href='#L350'>350</a>
+<a name='L351'></a><a href='#L351'>351</a>
+<a name='L352'></a><a href='#L352'>352</a>
+<a name='L353'></a><a href='#L353'>353</a>
+<a name='L354'></a><a href='#L354'>354</a>
+<a name='L355'></a><a href='#L355'>355</a>
+<a name='L356'></a><a href='#L356'>356</a>
+<a name='L357'></a><a href='#L357'>357</a>
+<a name='L358'></a><a href='#L358'>358</a>
+<a name='L359'></a><a href='#L359'>359</a>
+<a name='L360'></a><a href='#L360'>360</a>
+<a name='L361'></a><a href='#L361'>361</a>
+<a name='L362'></a><a href='#L362'>362</a>
+<a name='L363'></a><a href='#L363'>363</a>
+<a name='L364'></a><a href='#L364'>364</a>
+<a name='L365'></a><a href='#L365'>365</a>
+<a name='L366'></a><a href='#L366'>366</a>
+<a name='L367'></a><a href='#L367'>367</a>
+<a name='L368'></a><a href='#L368'>368</a>
+<a name='L369'></a><a href='#L369'>369</a>
+<a name='L370'></a><a href='#L370'>370</a>
+<a name='L371'></a><a href='#L371'>371</a>
+<a name='L372'></a><a href='#L372'>372</a>
+<a name='L373'></a><a href='#L373'>373</a>
+<a name='L374'></a><a href='#L374'>374</a>
+<a name='L375'></a><a href='#L375'>375</a>
+<a name='L376'></a><a href='#L376'>376</a>
+<a name='L377'></a><a href='#L377'>377</a>
+<a name='L378'></a><a href='#L378'>378</a>
+<a name='L379'></a><a href='#L379'>379</a>
+<a name='L380'></a><a href='#L380'>380</a>
+<a name='L381'></a><a href='#L381'>381</a>
+<a name='L382'></a><a href='#L382'>382</a>
+<a name='L383'></a><a href='#L383'>383</a>
+<a name='L384'></a><a href='#L384'>384</a>
+<a name='L385'></a><a href='#L385'>385</a>
+<a name='L386'></a><a href='#L386'>386</a>
+<a name='L387'></a><a href='#L387'>387</a>
+<a name='L388'></a><a href='#L388'>388</a>
+<a name='L389'></a><a href='#L389'>389</a>
+<a name='L390'></a><a href='#L390'>390</a>
+<a name='L391'></a><a href='#L391'>391</a>
+<a name='L392'></a><a href='#L392'>392</a>
+<a name='L393'></a><a href='#L393'>393</a>
+<a name='L394'></a><a href='#L394'>394</a>
+<a name='L395'></a><a href='#L395'>395</a>
+<a name='L396'></a><a href='#L396'>396</a>
+<a name='L397'></a><a href='#L397'>397</a>
+<a name='L398'></a><a href='#L398'>398</a>
+<a name='L399'></a><a href='#L399'>399</a>
+<a name='L400'></a><a href='#L400'>400</a>
+<a name='L401'></a><a href='#L401'>401</a>
+<a name='L402'></a><a href='#L402'>402</a>
+<a name='L403'></a><a href='#L403'>403</a>
+<a name='L404'></a><a href='#L404'>404</a>
+<a name='L405'></a><a href='#L405'>405</a>
+<a name='L406'></a><a href='#L406'>406</a>
+<a name='L407'></a><a href='#L407'>407</a>
+<a name='L408'></a><a href='#L408'>408</a>
+<a name='L409'></a><a href='#L409'>409</a>
+<a name='L410'></a><a href='#L410'>410</a>
+<a name='L411'></a><a href='#L411'>411</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-yes">780x</span>
+<span class="cline-any cline-yes">16510x</span>
+<span class="cline-any cline-yes">16510x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">16445x</span>
+<span class="cline-any cline-yes">16445x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">16445x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">16510x</span>
+<span class="cline-any cline-yes">17771x</span>
+<span class="cline-any cline-yes">43295x</span>
+<span class="cline-any cline-yes">43295x</span>
+<span class="cline-any cline-yes">43295x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">342x</span>
+<span class="cline-any cline-yes">342x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">36x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-yes">28x</span>
+<span class="cline-any cline-yes">28x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">34x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-yes">35x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">62x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">124x</span>
+<span class="cline-any cline-yes">2328x</span>
+<span class="cline-any cline-yes">68588x</span>
+<span class="cline-any cline-yes">68588x</span>
+<span class="cline-any cline-yes">68588x</span>
+<span class="cline-any cline-yes">68588x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">45x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">65x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">65x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
+ * Atlas Sprite Sheet Generator for Cyberia Online.
+ * Consolidates all object layer frames (8 directions, multiple modes) into a single PNG atlas.
+ * @module src/projects/cyberia/atlas-sprite-sheet-generator.js
+ * @namespace CyberiaAtlasSpriteSheetGenerator
+ */
+&nbsp;
+import { Jimp, rgbaToInt } from 'jimp';
+import { loggerFactory } from '../../server/ops/logger.js';
+import { getKeyframeDirectionsByCode } from '../../client/components/cyberia/SharedDefaultsCyberia.js';
+&nbsp;
+const logger = loggerFactory(import.meta);
+&nbsp;
+/** Direction code of the still an item is previewed by: down idle. */
+export const IDLE_PREVIEW_DIRECTION_CODE = '08';
+&nbsp;
+/**
+ * Pixels per cell of the human-resolution atlas, when no factor is given.
+ * @memberof CyberiaAtlasSpriteSheetGenerator
+ */
+export const DEFAULT_ATLAS_UPSCALE_FACTOR = 20;
+&nbsp;
+/**
+ * Pixels per cell of the minified atlas. The client runtime downloads this one,
+ * so it stays at one pixel per cell.
+ * @memberof CyberiaAtlasSpriteSheetGenerator
+ */
+const MINIFY_CELL_PIXEL_DIM = 1;
+&nbsp;
+/**
+ * @typedef {Object} AtlasFrame
+ * @property {number} x - X position in atlas
+ * @property {number} y - Y position in atlas
+ * @property {number} width - Frame width
+ * @property {number} height - Frame height
+ * @property {number} frameIndex - Frame index in animation
+ * @memberof CyberiaAtlasSpriteSheetGenerator
+ */
+&nbsp;
+/**
+ * Atlas Sprite Sheet Generator Engine
+ * @class
+ * @memberof CyberiaAtlasSpriteSheetGenerator
+ */
+export class AtlasSpriteSheetGenerator {
+  /**
+   * Converts frame matrix and color palette to a Jimp image
+   * @static
+   * @param {number[][]} frameMatrix - The frame matrix
+   * @param {number[][]} colors - Color palette
+   * @param {number} cellPixelDim - Pixel dimension per cell
+   * @returns {Promise&lt;Jimp&gt;} The generated image
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static async frameMatrixToImage(frameMatrix, colors, cellPixelDim = 1) {
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (!frameMatrix || frameMatrix.length === 0 || frameMatrix[0].length === 0) {
+<span class="cstat-no" title="statement not covered" >      throw new Error('Invalid frame matrix');</span>
+    }
+&nbsp;
+    const width = cellPixelDim * frameMatrix[0].length;
+    const height = cellPixelDim * frameMatrix.length;
+&nbsp;
+    const image = new Jimp({ width, height, color: 0x00000000 });
+&nbsp;
+    for (let y = 0; y &lt; frameMatrix.length; y++) {
+      for (let x = 0; x &lt; frameMatrix[y].length; x++) {
+        const colorIndex = frameMatrix[y][x];
+        if (colorIndex === null || colorIndex === undefined) continue;
+&nbsp;
+        const color = colors[colorIndex];
+        <span class="missing-if-branch" title="if path not taken" >I</span>if (!color) <span class="cstat-no" title="statement not covered" >continue;</span>
+&nbsp;
+        const rgbaColor = color.length === 4 ? color : <span class="branch-1 cbranch-no" title="branch not covered" >[...color, 255];</span>
+&nbsp;
+        for (let dy = 0; dy &lt; cellPixelDim; dy++) {
+          for (let dx = 0; dx &lt; cellPixelDim; dx++) {
+            const pixelX = x * cellPixelDim + dx;
+            const pixelY = y * cellPixelDim + dy;
+            image.setPixelColor(rgbaToInt(...rgbaColor), pixelX, pixelY);
+          }
+        }
+      }
+    }
+&nbsp;
+    return image;
+  }
+&nbsp;
+  /**
+   * Calculates optimal atlas dimensions based on frame count and size
+   * @static
+   * @param {Array} frameImages - Array of frame image objects
+   * @returns {number} Recommended atlas dimension (power of 2)
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static calculateOptimalDimension(frameImages) {
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (
+      !frameImages?.length ||
+      frameImages.some(
+        ({ width, height }) =&gt; !Number.isInteger(width) || !Number.isInteger(height) || width &lt;= 0 || height &lt;= 0,
+      )
+    ) {
+<span class="cstat-no" title="statement not covered" >      throw new Error('Invalid frame dimensions');</span>
+    }
+    const cols = Math.ceil(Math.sqrt(frameImages.length));
+    const rows = Math.ceil(frameImages.length / cols);
+    return AtlasSpriteSheetGenerator.nextPowerOf2(
+      Math.max(
+        cols * Math.max(...frameImages.map((frame) =&gt; frame.width)),
+        rows * Math.max(...frameImages.map((frame) =&gt; frame.height)),
+      ),
+    );
+  }
+&nbsp;
+  /**
+   * Consolidates all frames of an ObjectLayerRenderFrames into one atlas sprite sheet.
+   *
+   * One packing produces two renders of the same layout: `minifyBuffer` at one
+   * pixel per cell, which the client runtime downloads, and `buffer` at
+   * `upscaleFactor` pixels per cell for human viewing. `metadata` describes the
+   * minified render, so atlas metadata and the served blob always agree.
+   *
+   * @static
+   * @param {Object} objectLayerRenderFrames - The ObjectLayerRenderFrames document
+   * @param {string} itemKey - The item key for the atlas
+   * @param {number} [upscaleFactor=DEFAULT_ATLAS_UPSCALE_FACTOR] - Pixels per cell of the human-resolution render
+   * @param {number} [maxAtlasDim=null] - Maximum atlas dimension (auto-calculated if null)
+   * @returns {Promise&lt;{buffer: Buffer, minifyBuffer: Buffer, metadata: Object}&gt;} Both renders and the shared metadata
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static async generateAtlas(
+    objectLayerRenderFrames,
+    itemKey,
+    upscaleFactor = DEFAULT_ATLAS_UPSCALE_FACTOR,
+    maxAtlasDim = null,
+  ) {
+    if (!Number.isInteger(upscaleFactor) || upscaleFactor &lt; 1) throw new Error('Invalid pixel scale');
+    const { frames, colors } = objectLayerRenderFrames;
+    const frameDuration = Number(objectLayerRenderFrames?.frame_duration);
+&nbsp;
+    // Direction order for consistent packing
+    const directionOrder = [
+      'down_idle',
+      'up_idle',
+      'left_idle',
+      'right_idle',
+      'down_left_idle',
+      'down_right_idle',
+      'up_left_idle',
+      'up_right_idle',
+      'down_walking',
+      'up_walking',
+      'left_walking',
+      'right_walking',
+      'down_left_walking',
+      'down_right_walking',
+      'up_left_walking',
+      'up_right_walking',
+      'default_idle',
+      'none_idle',
+    ];
+&nbsp;
+    // The packing works on the minified render; the upscaled render reuses its layout.
+    const frameImages = [];
+&nbsp;
+    for (const direction of directionOrder) {
+      const directionFrames = frames[direction];
+      if (!directionFrames || directionFrames.length === 0) continue;
+&nbsp;
+      for (let frameIndex = 0; frameIndex &lt; directionFrames.length; frameIndex++) {
+        const frameMatrix = directionFrames[frameIndex];
+        try {
+          const frameImage = await AtlasSpriteSheetGenerator.frameMatrixToImage(
+            frameMatrix,
+            colors,
+            MINIFY_CELL_PIXEL_DIM,
+          );
+&nbsp;
+          frameImages.push({
+            image: frameImage,
+            frameMatrix,
+            direction,
+            frameIndex,
+            width: frameImage.bitmap.width,
+            height: frameImage.bitmap.height,
+          });
+        } catch (error) {
+<span class="cstat-no" title="statement not covered" >          logger.warn(`Failed to generate frame for ${itemKey} ${direction}[${frameIndex}]:`, error.message);</span>
+        }
+      }
+    }
+&nbsp;
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (frameImages.length === 0) {
+<span class="cstat-no" title="statement not covered" >      throw new Error(`No valid frames found for item: ${itemKey}`);</span>
+    }
+&nbsp;
+    // Auto-calculate optimal dimension if not specified
+    if (maxAtlasDim === null || maxAtlasDim === undefined) {
+      maxAtlasDim = AtlasSpriteSheetGenerator.calculateOptimalDimension(frameImages);
+      logger.info(
+        `Auto-calculated optimal atlas dimension: ${maxAtlasDim}x${maxAtlasDim} for ${frameImages.length} frames`,
+      );
+    }
+&nbsp;
+    if (!Number.isInteger(maxAtlasDim) || maxAtlasDim &lt;= 0 || maxAtlasDim &gt; 4096) {
+      throw new Error('Atlas dimension must be between 1 and 4096');
+    }
+&nbsp;
+    // Simple grid packing algorithm
+    const { packedFrames, atlasWidth, atlasHeight } = AtlasSpriteSheetGenerator.packFramesGrid(
+      frameImages,
+      maxAtlasDim,
+    );
+&nbsp;
+    logger.info(`Packing ${packedFrames.length} frames into ${atlasWidth}x${atlasHeight} atlas`);
+&nbsp;
+    // Validate dimensions before creating Jimp image
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (isNaN(atlasWidth) || isNaN(atlasHeight) || atlasWidth &lt;= 0 || atlasHeight &lt;= 0) {
+<span class="cstat-no" title="statement not covered" >      throw new Error(</span>
+        `Invalid atlas dimensions: ${atlasWidth}x${atlasHeight} (maxAtlasDim: ${maxAtlasDim}, frameCount: ${frameImages.length})`,
+      );
+    }
+&nbsp;
+    const minifyImage = new Jimp({ width: atlasWidth, height: atlasHeight, color: 0x00000000 });
+    const upscaledImage = new Jimp({
+      width: atlasWidth * upscaleFactor,
+      height: atlasHeight * upscaleFactor,
+      color: 0x00000000,
+    });
+&nbsp;
+    const frameMetadata = {};
+&nbsp;
+    for (const packedFrame of packedFrames) {
+      const { image, frameMatrix, x, y, direction, frameIndex } = packedFrame;
+&nbsp;
+      AtlasSpriteSheetGenerator.blitFrame(minifyImage, image, x, y);
+&nbsp;
+      // The same cell grid at a larger scale, so the upscaled atlas is an exact
+      // multiple of the layout the metadata describes.
+      if (upscaleFactor &gt; MINIFY_CELL_PIXEL_DIM) {
+        const upscaledFrame = await AtlasSpriteSheetGenerator.frameMatrixToImage(frameMatrix, colors, upscaleFactor);
+        AtlasSpriteSheetGenerator.blitFrame(upscaledImage, upscaledFrame, x * upscaleFactor, y * upscaleFactor);
+      } else {
+        AtlasSpriteSheetGenerator.blitFrame(upscaledImage, image, x, y);
+      }
+&nbsp;
+      if (!frameMetadata[direction]) {
+        frameMetadata[direction] = [];
+      }
+&nbsp;
+      frameMetadata[direction][frameIndex] = {
+        x,
+        y,
+        width: image.bitmap.width,
+        height: image.bitmap.height,
+        frameIndex,
+      };
+    }
+&nbsp;
+    const metadata = {
+      itemKey,
+      atlasWidth,
+      atlasHeight,
+      cellPixelDim: MINIFY_CELL_PIXEL_DIM,
+      upscaleFactor,
+      frame_duration: Number.isFinite(frameDuration) ? frameDuration : 100,
+      frames: frameMetadata,
+    };
+&nbsp;
+    return {
+      buffer: await upscaledImage.getBuffer('image/png'),
+      minifyBuffer: await minifyImage.getBuffer('image/png'),
+      metadata,
+    };
+  }
+&nbsp;
+  /**
+   * The frame an item is previewed by: the first frame of the first down-idle keyframe the
+   * atlas carries, or the first frame of any direction when it has none.
+   *
+   * @static
+   * @param {Object} metadata - Atlas metadata as {@link generateAtlas} returns it.
+   * @returns {{x:number,y:number,width:number,height:number}|null} Frame box in minified cells.
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static idlePreviewFrame(metadata) {
+    const frames = metadata?.frames ?? <span class="branch-1 cbranch-no" title="branch not covered" >{};</span>
+    const preferred = getKeyframeDirectionsByCode(IDLE_PREVIEW_DIRECTION_CODE);
+    for (const direction of [...preferred, ...Object.keys(frames)]) {
+      const frame = frames[direction]?.[0];
+      if (frame) return frame;
+    }
+<span class="cstat-no" title="statement not covered" >    return null;</span>
+  }
+&nbsp;
+  /**
+   * Cuts the idle-preview still out of the human-resolution render, using the same layout
+   * `metadata.frames` describes for the minified one scaled by `metadata.upscaleFactor`.
+   *
+   * @static
+   * @param {Buffer} buffer - PNG bytes of the human-resolution atlas render.
+   * @param {Object} metadata - Atlas metadata as {@link generateAtlas} returns it.
+   * @returns {Promise&lt;Buffer|null&gt;} PNG bytes of the still, or null when the atlas has no frame.
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static async idlePreviewFromAtlas(buffer, metadata) {
+    const frame = AtlasSpriteSheetGenerator.idlePreviewFrame(metadata);
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (!frame) <span class="cstat-no" title="statement not covered" >return null;</span>
+    const scale = Number(metadata.upscaleFactor) || <span class="branch-1 cbranch-no" title="branch not covered" >1;</span>
+    const image = await Jimp.read(buffer);
+    image.crop({ x: frame.x * scale, y: frame.y * scale, w: frame.width * scale, h: frame.height * scale });
+    return await image.getBuffer('image/png');
+  }
+&nbsp;
+  /**
+   * Copies a frame image onto an atlas canvas at the given origin.
+   * @static
+   * @param {Jimp} atlasImage - Destination atlas canvas.
+   * @param {Jimp} frameImage - Source frame image.
+   * @param {number} originX - Destination X origin.
+   * @param {number} originY - Destination Y origin.
+   * @returns {void}
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static blitFrame(atlasImage, frameImage, originX, originY) {
+    for (let srcY = 0; srcY &lt; frameImage.bitmap.height; srcY++) {
+      for (let srcX = 0; srcX &lt; frameImage.bitmap.width; srcX++) {
+        const destX = originX + srcX;
+        const destY = originY + srcY;
+        <span class="missing-if-branch" title="if path not taken" >I</span>if (destX &gt;= atlasImage.bitmap.width || destY &gt;= atlasImage.bitmap.height) <span class="cstat-no" title="statement not covered" >continue;</span>
+        atlasImage.setPixelColor(frameImage.getPixelColor(srcX, srcY), destX, destY);
+      }
+    }
+  }
+&nbsp;
+  /**
+   * Simple grid-based frame packing algorithm
+   * @static
+   * @param {Array} frameImages - Array of frame image objects
+   * @param {number} maxDim - Maximum atlas dimension
+   * @returns {{packedFrames: Array, atlasWidth: number, atlasHeight: number}}
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static packFramesGrid(frameImages, maxDim) {
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (frameImages.length === 0) {
+<span class="cstat-no" title="statement not covered" >      throw new Error('No frames to pack');</span>
+    }
+&nbsp;
+    // Sort frames by height (tallest first) for better packing
+    const sortedFrames = [...frameImages].sort((a, b) =&gt; b.height - a.height || b.width - a.width);
+&nbsp;
+    const packedFrames = [];
+    let currentX = 0;
+    let currentY = 0;
+    let rowHeight = 0;
+    let maxWidth = 0;
+    let totalHeight = 0;
+&nbsp;
+    for (const frame of sortedFrames) {
+      // Check if frame fits in current row
+      if (currentX + frame.width &gt; maxDim) {
+        // Move to next row
+        currentX = 0;
+        currentY += rowHeight;
+        rowHeight = 0;
+      }
+&nbsp;
+      if (frame.width &gt; maxDim || currentY + frame.height &gt; maxDim) {
+        throw new Error(`Frames exceed atlas dimension ${maxDim}`);
+      }
+&nbsp;
+      packedFrames.push({
+        ...frame,
+        x: currentX,
+        y: currentY,
+      });
+&nbsp;
+      currentX += frame.width;
+      rowHeight = Math.max(rowHeight, frame.height);
+      maxWidth = Math.max(maxWidth, currentX);
+      totalHeight = Math.max(totalHeight, currentY + frame.height);
+    }
+&nbsp;
+    const atlasWidth = maxWidth;
+    const atlasHeight = totalHeight;
+&nbsp;
+    return {
+      packedFrames,
+      atlasWidth,
+      atlasHeight,
+    };
+  }
+&nbsp;
+  /**
+   * Returns the next power of 2 greater than or equal to n
+   * @static
+   * @param {number} n - Input number
+   * @returns {number} Next power of 2
+   * @memberof CyberiaAtlasSpriteSheetGenerator
+   */
+  static nextPowerOf2(n) {
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (n &lt;= 0) <span class="cstat-no" title="statement not covered" >return 1;</span>
+    n--;
+    n |= n &gt;&gt; 1;
+    n |= n &gt;&gt; 2;
+    n |= n &gt;&gt; 4;
+    n |= n &gt;&gt; 8;
+    n |= n &gt;&gt; 16;
+    return n + 1;
+  }
+}
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-09-13T20:21:13.226Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>