chore: add .npmignore and update package.json scripts for build process

Author: kalwalt

.npmignore

@@ -0,0 +1,16 @@
+examples/
+tests/
+docs/
+.github/
+.husky/
+*.test.js
+*.config.js
+*.config.mjs
+.editorconfig
+.gitattributes
+.lintstagedignore
+.nvmrc
+.prettierignore
+.prettierrc.json
+eslint.config.mjs
+vitest.config.js

README.md

@@ -205,3 +205,27 @@ If the camera doesn’t start, click to allow autoplay. On Safari, prefer HTTPS
 - Legacy API (Source/Profile/Session/SessionDebugUI) removed from core.
 - Core focuses on ECS + plugins; renderer integrations live externally (e.g., arjs-plugin-threejs).
 - Import from the bundled library (ESM .mjs or CJS .js) as shown above.
+
+## Development
+
+### Building
+
+The `dist` folder contains the built library files and is automatically generated.
+
+**To build manually:**
+
+```bash
+npm run build
+```
+
+This will:
+
+1. Generate TypeScript type definitions in `types/`
+2. Bundle the library files to `dist/`
+
+**Note:** The `dist` folder is automatically built when:
+
+- Running `npm pack` (via the `prepack` script)
+- Publishing to npm with `npm publish`
+
+You don't need to commit the `dist` folder to git - it will be generated fresh during the publish process.

package.json

@@ -21,6 +21,8 @@
     "build-types": "tsc",
     "dev:vite": "vite",
     "build:vite": "vite build --config vite.config.mjs",
+    "build": "npm run build-types && npm run build:vite",
+    "prepack": "npm run build",
     "serve:vite": "vite preview",
     "test": "vitest",
     "test:watch": "vitest --watch",
@@ -57,5 +59,13 @@
     "*.{js,jsx,ts,tsx}": [
       "eslint --fix --cache"
     ]
-  }
+  },
+  "files": [
+    "dist",
+    "src",
+    "plugins",
+    "types",
+    "README.md",
+    "LICENSE"
+  ]
 }