Merge pull request #4 from AR-js-org/copilot/add-ecs-architecture-and-plugins

Add ECS architecture and plugin system with source capture plugins

Author: kalwalt

.editorconfig

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

.gitattributes

@@ -0,0 +1,22 @@
+# Enforce LF for source and text files across platforms
+*.js text eol=lf
+*.mjs text eol=lf
+*.cjs text eol=lf
+*.ts text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.css text eol=lf
+*.html text eol=lf
+
+# Keep binary files untouched
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.webp binary
+*.mp4 binary
+*.mp3 binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.otf binary

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+name: CI
+
+on:
+  push:
+    branches: ['**'] # run on pushes to all branches
+    paths:
+      - 'src/**'
+      - 'plugins/**'
+      - 'examples/**'
+      - 'tests/**'
+      - 'package.json'
+      - 'vite.config.js'
+      - 'vitest.config.js'
+      - '.github/workflows/**'
+  pull_request:
+    branches: ['**'] # run on PRs against any branch
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # Primary job: format/lint, webpack build, then tests with coverage.
+  build-and-test:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js (from .nvmrc)
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm install
+          fi
+
+      - name: Prettier check
+        run: npm run format-check
+
+      - name: ESLint
+        run: npm run lint
+
+      # Use the webpack build for CI stability (dist via webpack)
+      - name: Build (webpack)
+        run: npm run build
+
+      - name: Run tests (with coverage)
+        run: npm run test:coverage
+        env:
+          CI: true
+
+      - name: Upload coverage artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage
+          if-no-files-found: ignore
+
+  # Secondary job: attempt Vite build with mitigations; doesn't fail the PR if it breaks.
+  vite-build-linux:
+    runs-on: ubuntu-24.04
+    continue-on-error: true
+    needs: build-and-test
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js (from .nvmrc)
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm install
+          fi
+
+      - name: Diagnostics (platform and rollup)
+        run: |
+          node -e "console.log('platform:', process.platform, 'arch:', process.arch, 'node:', process.version)"
+          npm ls rollup @rollup/rollup-linux-x64-gnu vite || true
+
+      # Workaround: ensure Linux native binary is present. Harmless if already resolved.
+      - name: Ensure rollup native linux package
+        run: npm i -D @rollup/rollup-linux-x64-gnu@^4 || true
+
+      - name: Vite build (library)
+        run: npm run build:vite
+        env:
+          # Ask rollup to use JS fallback if native optional dep is still missing
+          ROLLUP_SKIP_NODEJS_NATIVE: '1'

.gitignore

@@ -1 +1,5 @@
-node_modules
+node_modules
+dist
+.idea/
+coverage/
+.eslintcache

.husky/pre-commit

@@ -0,0 +1,2 @@
+# Only format and lint what's staged (fast)
+npx lint-staged

.lintstagedignore

@@ -0,0 +1,5 @@
+examples/vite-artoolkit/vendor/**
+examples/vite-artoolkit/data/**
+*.dat
+*.hiro
+*.map

.nvmrc

@@ -0,0 +1 @@
+v22.21.1

.prettierignore

@@ -1,2 +1,7 @@
 types
-dist
+dist
+examples/vite-artoolkit/vendor/**
+examples/vite-artoolkit/data/**
+*.dat
+*.hiro
+*.map

.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "semi": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}