@lightningjs/blits 1.30.1 → 1.31.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+_27 jun 2025_
+
+## v1.31.0
+
+- Added dereferencing of previousFocus pointer to ensure memory release
+- Added npm ignore to reduce NPM package size
+- Added support for precompilation of `.mjs` files
+- Upgraded renderer to v2.14.3
+
+
+_25 jun 2025_
+
+## v1.30.2
+
+- Bumped renderer to v2.14.2
+
+
 _25 jun 2025_
 
 ## v1.30.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightningjs/blits",
-  "version": "1.30.1",
+  "version": "1.31.0",
   "description": "Blits: The Lightning 3 App Development Framework",
   "bin": "bin/index.js",
   "exports": {
@@ -19,7 +19,8 @@
     "lint:fix": "eslint '**/*.js' --fix",
     "prepublishOnly": "node scripts/prepublishOnly.js",
     "postpublish": "node scripts/postpublish.js",
-    "prepare": "husky"
+    "prepare": "husky",
+    "pack-preview": "npm pack --dry-run"
   },
   "types": "./index.d.ts",
   "lint-staged": {
@@ -47,7 +48,7 @@
   },
   "dependencies": {
     "@lightningjs/msdf-generator": "^1.1.1",
-    "@lightningjs/renderer": "^2.14.1"
+    "@lightningjs/renderer": "^2.14.3"
   },
   "repository": {
     "type": "git",

package/src/router/router.js

@@ -433,6 +433,8 @@ const removeView = async (route, view, transition) => {
     view.destroy()
     view = null
   }
+
+  previousFocus = null
 }
 
 const setOrAnimate = (node, transition, shouldAnimate = true) => {

package/vite/preCompiler.js

@@ -31,7 +31,12 @@ export default function () {
       const fileExtension = path.extname(filePath)
 
       // we should only precompile .blits, .js and .ts files
-      if (fileExtension === '.js' || fileExtension === '.ts' || fileExtension === '.blits') {
+      if (
+        fileExtension === '.js' ||
+        fileExtension === '.ts' ||
+        fileExtension === '.blits' ||
+        fileExtension === '.mjs'
+      ) {
         return compiler(source, filePath, config.mode)
       }
 

package/.editorconfig

@@ -1,7 +0,0 @@
-[*]
-charset = utf-8
-indent_size = 2
-indent_style = space
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true

package/.eslintignore

@@ -1 +0,0 @@
-**/node_modules

package/.eslintrc.cjs

@@ -1,65 +0,0 @@
-/*
- * If not stated otherwise in this file or this component's LICENSE file the
- * following copyright and licenses apply:
- *
- * Copyright 2023 Comcast
- *
- * Licensed under the Apache License, Version 2.0 (the License);
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-module.exports = {
-  root: true,
-  env: {
-    browser: true,
-    es6: true,
-    node: true,
-  },
-  plugins: ['prettier'],
-  extends: ['eslint:recommended', 'plugin:prettier/recommended', 'prettier'],
-  rules: {
-    'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    quotes: [2, 'single', 'avoid-escape'],
-    semi: [2, 'never'],
-    'no-extra-boolean-cast': 'off',
-    'no-unused-vars': [
-      1,
-      {
-        argsIgnorePattern: 'res|next|^err',
-      },
-    ],
-    'prettier/prettier': [
-      'error',
-      {
-        trailingComma: 'es5',
-        singleQuote: true,
-        tabWidth: 2,
-        semi: false,
-        printWidth: 100,
-        endOfLine: 'auto',
-      },
-    ],
-  },
-  parser: '@babel/eslint-parser',
-  parserOptions: {
-    ecmaVersion: 2018,
-    sourceType: 'module',
-    requireConfigFile: false,
-    babelOptions: {
-      plugins: ['@babel/plugin-syntax-import-assertions'],
-    },
-  },
-  globals: {
-    globalThis: false,
-  },
-}

package/.github/workflows/comment-lint-results.yml

@@ -1,125 +0,0 @@
-name: Comment ESLint Results
-
-on:
-  workflow_run:
-    workflows: ["Run ESLint"]
-    types:
-      - completed
-
-jobs:
-  comment-lint-results:
-    if: github.event.workflow_run.conclusion == 'failure'
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-
-    steps:
-      - name: Download Lint Results
-        id: download
-        uses: actions/github-script@v6
-        with:
-          result-encoding: string
-          script: |
-
-            try {
-              core.info('Downloading lint-results artifact');
-              const runId = context.payload.workflow_run.id;
-
-              const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                run_id: runId
-              });
-
-              const art = artifacts.data.artifacts.find(a => a.name === "lint-results");
-              if (!art) {
-                core.setFailed('No lint-results artifact found');
-                return 'false';
-              }
-
-              core.info(`Found artifact id ${art.id}, downloading…`);
-              const dl = await github.rest.actions.downloadArtifact({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                artifact_id: art.id,
-                archive_format: 'zip'
-              });
-
-              require('fs').writeFileSync('lint-results.zip', Buffer.from(dl.data));
-              core.info('Downloaded and saved lint-results.zip');
-              return 'true';
-
-            } catch (err) {
-              core.setFailed(`Download failed: ${err.message}`);
-              return 'false';
-            }
-
-      - name: Extract Lint Results
-        if: steps.download.outputs.result == 'true'
-        id: extract
-        run: |
-          mkdir -p extracted
-          unzip -o lint-results.zip -d extracted
-
-          # Read PR information
-          if [ -f extracted/pr_number.txt ]; then
-            echo "PR_NUMBER=$(cat extracted/pr_number.txt)" >> $GITHUB_ENV
-          else
-            echo "PR_NUMBER=0" >> $GITHUB_ENV
-          fi
-
-          if [ -f extracted/errors.md ] || [ -f extracted/lint-results/errors.md ]; then
-            if [ -f extracted/errors.md ]; then
-              # Handle flat structure
-              echo "LINT_ERRORS<<EOF" >> $GITHUB_ENV
-              cat extracted/errors.md >> $GITHUB_ENV
-              echo "EOF" >> $GITHUB_ENV
-            else
-              # Handle nested structure
-              echo "LINT_ERRORS<<EOF" >> $GITHUB_ENV
-              cat extracted/lint-results/errors.md >> $GITHUB_ENV
-              echo "EOF" >> $GITHUB_ENV
-            fi
-            echo "HAS_ERRORS=true" >> $GITHUB_OUTPUT
-          else
-            echo "HAS_ERRORS=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Post Lint Results as PR Comment
-        if: steps.extract.outputs.HAS_ERRORS == 'true'
-        uses: actions/github-script@v6
-        with:
-          script: |
-            try {
-              // First check if PR number was passed from the lint workflow
-              let prNumber = parseInt(process.env.PR_NUMBER);
-
-              // Fallback to the workflow_run PR data if available
-              if (!prNumber || isNaN(prNumber) || prNumber === 0) {
-                const pulls = context.payload.workflow_run.pull_requests;
-                core.info(`Looking for PR information in workflow_run: Found ${pulls.length} PR(s)`);
-
-                if (pulls.length === 0) {
-                  core.warning('No pull request information found. Skipping comment.');
-                  return;
-                }
-
-                prNumber = pulls[0].number;
-              }
-
-              core.info(`Posting lint errors comment to PR #${prNumber}`);
-
-              const body = process.env.LINT_ERRORS;
-
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: prNumber,
-                body
-              });
-
-              core.info('Lint errors comment posted successfully');
-            } catch (err) {
-              core.error('Failed to post lint comment:', err);
-              core.setFailed(err.message);
-            }

package/.github/workflows/comment-test-results.yml

@@ -1,109 +0,0 @@
-name: Comment Test Results
-
-on:
-  workflow_run:
-    workflows: ["Run Blits Tests"]
-    types: [completed]
-
-jobs:
-  comment-test-results:
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-
-    steps:
-      - name: Download Test Results
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              run_id: ${{ github.event.workflow_run.id }}
-            });
-            const art = artifacts.data.artifacts.find(a => a.name === "test-results");
-            if (!art) {
-              core.setFailed('No test-results artifact found');
-              return;
-            }
-            const dl = await github.rest.actions.downloadArtifact({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              artifact_id: art.id,
-              archive_format: 'zip'
-            });
-            require('fs').writeFileSync('test-results.zip', Buffer.from(dl.data));
-
-      - name: Extract Test Results
-        run: |
-
-          mkdir -p extracted
-          unzip -o test-results.zip -d extracted
-
-          # Set environment variables from the extracted files
-          echo "TIMESTAMP=$(cat extracted/timestamp.txt)" >> $GITHUB_ENV
-          echo "SUMMARY=$(cat extracted/summary.txt)" >> $GITHUB_ENV
-          echo "FAILED=$(cat extracted/failed.txt)" >> $GITHUB_ENV
-
-          # Read PR information
-          if [ -f extracted/pr_number.txt ]; then
-            echo "PR_NUMBER=$(cat extracted/pr_number.txt)" >> $GITHUB_ENV
-          else
-            echo "PR_NUMBER=0" >> $GITHUB_ENV
-          fi
-
-
-          # Copy error file if it exists
-          if [ -f extracted/error.txt ]; then
-            cp extracted/error.txt raw_error.txt
-          fi
-
-      - name: Post Test Results as PR Comment
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const fs = require('fs');
-
-            try {
-              // First check if PR number was passed from the test workflow
-              let prNumber = parseInt(process.env.PR_NUMBER);
-
-              // Fallback to the workflow_run PR data if available
-              if (!prNumber || isNaN(prNumber) || prNumber === 0) {
-                const pulls = context.payload.workflow_run.pull_requests;
-                console.log(`Looking for PR information in workflow_run: Found ${pulls.length} PR(s).`);
-
-                if (pulls.length === 0) {
-                  console.warn('No pull request information found. Skipping comment.');
-                  return;
-                }
-
-                prNumber = pulls[0].number;
-              }
-
-              console.log(`Posting comment to PR #${prNumber}`);
-
-              const status = process.env.FAILED === 'true' ? '❌ FAILED' : '✅ PASSED';
-              let commentBody = `#### Test Results: ${status}\n`
-                              + `**Run at:** ${process.env.TIMESTAMP}\n\n`
-                              + `**Summary:**\n${process.env.SUMMARY}`;
-
-              if (fs.existsSync('raw_error.txt')) {
-                commentBody += '\n\n**Error Output:**\n```\n'
-                             + fs.readFileSync('raw_error.txt', 'utf8')
-                             + '\n```';
-              }
-
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: prNumber,
-                body: commentBody
-              });
-
-              console.log(`Successfully posted comment to PR #${prNumber}`);
-
-            } catch (err) {
-              console.error('🛑 Failed to post test results comment:', err);
-              core.setFailed(`Comment step failed: ${err.message}`);
-            }

package/.github/workflows/deploy-docs.yml

@@ -1,27 +0,0 @@
-name: Trigger Website Docs Update
-
-on:
-  push:
-    branches: [ master ]
-    paths:
-      - 'docs/**'
-
-jobs:
-  trigger:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Trigger Deployment
-        timeout-minutes: 5
-        run: |
-          response=$(curl -X POST -d {} -H "Content-Type:application/json" -w "%{http_code}" -s -o /dev/null \
-            --max-time 30 \
-            --connect-timeout 10 \
-            --retry 2 \
-            --retry-delay 5 \
-            "${{ secrets.WEBSITE_DEPLOY_URL }}")
-          if [ "$response" -ge 200 ] && [ "$response" -lt 300 ]; then
-            echo "Deployment triggered successfully"
-          else
-            echo "Failed to trigger deployment. Status code: $response"
-            exit 1
-          fi

package/.github/workflows/run-blits-tests.yml

@@ -1,142 +0,0 @@
-name: Run Blits Tests
-
-on:
-  pull_request:
-    branches:
-      - dev
-      - master
-
-jobs:
-  run-blits-tests:
-    runs-on: ubuntu-latest
-    outputs:
-      tests_failed: ${{ steps.analyze-results.outputs.result && fromJSON(steps.analyze-results.outputs.result).testsFailed }}
-
-    steps:
-    - name: Checkout Code
-      uses: actions/checkout@v3
-
-    - name: Set up Node.js
-      uses: actions/setup-node@v3
-      with:
-        node-version: 20.16.0
-
-    - name: Save PR Information
-      run: |
-        echo '${{ github.event.pull_request.number }}' > ./pr_number.txt
-        echo '${{ github.event.pull_request.head.repo.full_name }}' > ./pr_repo.txt
-        echo '${{ github.event.pull_request.head.ref }}' > ./pr_branch.txt
-
-    - name: Install Dependencies
-      run: npm install
-
-    - name: Run Tests
-      id: run-tests
-      run: npm run test > test-report.txt 2>&1 || echo "Command failed with exit code $?" >> test-report.txt
-
-    - name: Analyze Test Results
-      id: analyze-results
-      uses: actions/github-script@v6
-      with:
-        result-encoding: json
-        script: |
-          const fs = require('fs');
-          const timestamp = new Date().toISOString();
-
-          const results = {
-            timestamp,
-            summary: '',
-            testsFailed: false,
-            error: null
-          };
-
-          // Check if test report exists and has content
-          if (!fs.existsSync('test-report.txt') || !fs.statSync('test-report.txt').size) {
-            results.summary = 'Test execution error: No test output generated.';
-            results.testsFailed = true;
-            return outputResults(results);
-          }
-
-          // Read test report
-          const testOutput = fs.readFileSync('test-report.txt', 'utf8');
-
-          // Check for errors and test results
-          const hasError = testOutput.includes('Error');
-          const testSummaryMatch = testOutput.match(/passed:\s*(\d+)\s*failed:\s*(\d+)\s*of\s*(\d+)\s*tests/);
-
-          if (hasError && (!testSummaryMatch || testSummaryMatch[3] === '0')) {
-            // Error with no tests or zero tests
-            results.summary = 'Test execution encountered errors. No tests were run.';
-            results.testsFailed = true;
-            results.error = testOutput;
-          } else if (testSummaryMatch) {
-            // We have a test summary
-            const passed = parseInt(testSummaryMatch[1]);
-            const failed = parseInt(testSummaryMatch[2]);
-            const total = parseInt(testSummaryMatch[3]);
-
-            results.summary = testSummaryMatch[0];
-
-            if (failed > 0 || total === 0) {
-              results.testsFailed = true;
-
-              if (total === 0) {
-                results.summary = 'No tests were found to run. This is considered a failure.';
-              }
-            }
-          } else {
-            // No test summary found
-            results.summary = 'Test execution produced no valid test summary';
-            results.testsFailed = true;
-            results.error = testOutput;
-          }
-
-          return outputResults(results);
-
-          /**
-           * Outputs results and saves result files
-           */
-          function outputResults(results) {
-            try {
-              fs.writeFileSync('./timestamp.txt', results.timestamp);
-              fs.writeFileSync('./summary.txt', results.summary);
-              fs.writeFileSync('./failed.txt', results.testsFailed.toString());
-
-              // Save error output if it exists
-              if (results.error) {
-                fs.writeFileSync('./error.txt', results.error);
-              }
-            } catch (err) {
-              console.error('Error saving test results:', err);
-              core.warning(`Error saving test results: ${err.message}`);
-            }
-
-            return results;
-          }
-
-    - name: Upload Test Report Artifact
-      if: always()
-      uses: actions/upload-artifact@v4
-      with:
-        name: test-report
-        path: test-report.txt
-
-    - name: Upload Test Results
-      if: always()
-      uses: actions/upload-artifact@v4
-      with:
-        name: test-results
-        path: |
-
-          ./timestamp.txt
-          ./summary.txt
-          ./failed.txt
-          ./error.txt
-          ./pr_number.txt
-          ./pr_repo.txt
-          ./pr_branch.txt
-
-    # Fail the workflow if tests failed
-    - name: Check Test Status
-      if: ${{ steps.analyze-results.outputs.result && fromJSON(steps.analyze-results.outputs.result).testsFailed }}
-      run: exit 1

package/.github/workflows/run-lint.yml

@@ -1,128 +0,0 @@
-name: Run ESLint
-
-on:
-  pull_request:
-    branches:
-      - dev
-      - master
-
-jobs:
-  run-lint:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-
-    steps:
-    - name: Checkout Code
-      uses: actions/checkout@v3
-      with:
-        # Needed to compare changes against base branch
-        fetch-depth: 0
-
-    - name: Save PR Information
-      run: |
-        echo '${{ github.event.pull_request.number }}' > ./pr_number.txt
-        echo '${{ github.event.pull_request.head.repo.full_name }}' > ./pr_repo.txt
-        echo '${{ github.event.pull_request.head.ref }}' > ./pr_branch.txt
-
-    - name: Set up Node.js
-      uses: actions/setup-node@v3
-      with:
-        node-version: 20.16.0
-
-    - name: Install Dependencies
-      run: npm install
-
-    - name: Get list of changed JS files
-      id: changed-files
-      run: |
-        # Get the list of changed .js files compared to the base branch
-        git diff --name-only --diff-filter=ACMRT origin/${{ github.base_ref }} HEAD | grep '\.js$' > js-changed-files.txt || true
-
-        if [ -s js-changed-files.txt ]; then
-          echo "has_js_changes=true" >> $GITHUB_OUTPUT
-          cat js-changed-files.txt | tr '\n' ' ' > js-changed-files-spaces.txt
-          echo "files=$(cat js-changed-files-spaces.txt)" >> $GITHUB_OUTPUT
-        else
-          echo "has_js_changes=false" >> $GITHUB_OUTPUT
-        fi
-
-    - name: Run ESLint on changed files
-      id: eslint
-      if: steps.changed-files.outputs.has_js_changes == 'true'
-      run: |
-        # Create directory for output
-        mkdir -p ./lint-results
-
-        # Run ESLint only on changed files with the project's config
-        # Filtering out warnings - only keep errors
-        npx eslint --config .eslintrc.cjs ${{ steps.changed-files.outputs.files }} -f json > ./lint-results/eslint-output.json || true
-
-        # Check if there are any errors in the ESLint output
-        if [ -s ./lint-results/eslint-output.json ]; then
-          error_count=$(node -e "
-            const results = require('./lint-results/eslint-output.json');
-            let errorCount = 0;
-            for (const file of results) {
-              errorCount += file.errorCount || 0;
-            }
-            console.log(errorCount);
-          ")
-
-          echo "errors_found=$error_count" >> $GITHUB_OUTPUT
-
-          if [ "$error_count" -gt 0 ]; then
-            # Create the formatted error report
-            echo '❌ **Linting errors found**' > ./lint-results/errors.md
-            echo '' >> ./lint-results/errors.md
-            echo 'These linting errors must be fixed before this PR can be merged:' >> ./lint-results/errors.md
-            echo '' >> ./lint-results/errors.md
-            echo '```' >> ./lint-results/errors.md
-
-            # Extract and format errors from the JSON
-            error_count=$(node -e "
-              const results = require('./lint-results/eslint-output.json');
-              let errorSummary = '';
-
-              for (const file of results) {
-                if (file.errorCount > 0) {
-                  const filePath = file.filePath.replace(process.env.GITHUB_WORKSPACE + '/', '');
-                  errorSummary += filePath + '\\n';
-
-                  for (const msg of file.messages) {
-                    if (msg.severity === 2) {
-                      errorSummary += '  Line ' + msg.line + ':' + msg.column + ': ' +
-                                     msg.message + ' (' + msg.ruleId + ')\\n';
-                    }
-                  }
-                  errorSummary += '\\n';
-                }
-              }
-
-              console.log(errorSummary.trim());
-            ")
-
-            echo "$error_count" >> ./lint-results/errors.md
-            echo '```' >> ./lint-results/errors.md
-            echo '' >> ./lint-results/errors.md
-            echo '_Run `npm run lint:fix` to automatically fix some of these issues._' >> ./lint-results/errors.md
-          fi
-        else
-          echo "errors_found=0" >> $GITHUB_OUTPUT
-        fi
-
-    - name: Upload Lint Results
-      if: steps.changed-files.outputs.has_js_changes == 'true'
-      uses: actions/upload-artifact@v4
-      with:
-        name: lint-results
-        path: |
-          ./lint-results/
-          ./pr_number.txt
-          ./pr_repo.txt
-          ./pr_branch.txt
-
-    # Fail the workflow if linting errors found
-    - name: Check Lint Status
-      if: steps.changed-files.outputs.has_js_changes == 'true' && steps.eslint.outputs.errors_found != '0'
-      run: exit 1

package/.husky/pre-commit

@@ -1 +0,0 @@
-npx lint-staged

package/.husky/pre-push

@@ -1 +0,0 @@
-node ./scripts/prepush.js