Next

.github/copilot-instructions.md

@@ -0,0 +1,76 @@
+# GitHub Copilot Instructions for slickgrid-universal
+
+## Repository Overview
+This is a monorepo for SlickGrid Universal containing:
+- Core packages in `packages/` (common, plugins, exports, etc.)
+- Framework wrappers in `frameworks/` (Angular, React, Vue, Aurelia)
+- Demo applications in `demos/` for each framework
+  - except Angular demos which are located in `frameworks/angular-slickgrid/src/demos`
+- Shared test utilities in `test/`
+
+## Code Standards
+
+### Testing
+- Use **Vitest** for unit tests (`.spec.ts` files)
+- Use **Cypress** for E2E tests (`.cy.ts` files in `test/cypress/e2e/`)
+- Aim for 100% statement coverage on core functionality
+- Test files are usually in `__tests__/` subdirectory (or same folder if only 1-2 test files)
+- Unit tests exist in 2 implementations:
+  - Native/vanilla implementation: all under `packages/`
+  - Angular-specific tests: under `frameworks/angular-slickgrid/`
+
+### TypeScript Patterns
+- Use strict TypeScript with proper typing
+- Prefer `interface` over `type` for object shapes
+- Use `protected` for class methods that may be extended
+- Follow existing naming conventions: `_privateField`, `publicMethod`
+
+### Code Formatting & Linting
+- **OXLint** is used for linting TypeScript/JavaScript code
+- **Prettier** handles code formatting automatically
+- Code should be formatted before committing
+- Run `pnpm lint:fix` to auto-fix linting issues
+- Run `pnpm prettier:write` to format code
+- Ensure no linting errors before creating pull requests
+
+### Plugin Development
+- All plugins extend SlickGrid and use `SlickEventHandler`
+- Use `BindingEventService` for DOM event binding/cleanup
+- Always implement `init()`, `dispose()`, and `getOptions()`/`setOptions()`
+- Plugins should support both grid options and column definition options
+
+### Framework Support
+When making changes to demos or documentation:
+- Update **all 4 frameworks**: Angular, React, Vue, Aurelia
+- Maintain consistency across framework implementations
+- Check for framework-specific syntax (e.g., Vue's template vs React's JSX)
+
+### Documentation
+- Update corresponding docs in `docs/` AND framework-specific `frameworks/*/docs/`
+- Use markdown with proper linking: `[file.ts](path/to/file.ts)`
+- Include code examples that work across frameworks
+
+## Common Commands
+- `pnpm build` - Build all packages
+  - aka "Build Everything" task, which builds all packages and frameworks in the monorepo
+- `pnpm lint` - Run linter (OXLint) on all files
+- `pnpm lint:fix` - Auto-fix linting issues
+- `pnpm prettier:check` - Check code formatting
+- `pnpm prettier:write` - Format code with Prettier
+- `pnpm test` - Run Vitest unit tests  
+- `pnpm test:coverage` - Run tests with coverage
+- `pnpm dev` - Start vanilla demo
+- `pnpm dev:[framework]` - Start framework-specific demos 
+  - e.g.: `dev:angular`, `dev:react`, `dev:vue`, `dev:aurelia`
+
+## Monorepo Structure
+- Changes to `packages/*` affect all frameworks
+- Framework wrappers depend on core packages
+- Use relative imports within packages
+- Avoid circular dependencies
+
+## Code Review Focus
+- Maintain backward compatibility
+- Consider impact across all 4 framework implementations
+- Verify tests pass and coverage remains high
+- Check that examples work in all framework demos

.github/renovate.json5

@@ -25,13 +25,6 @@
         enabled: false,
       },
     },
-    {
-      description: 'Prevent major updates for Vite 6 catalog',
-      matchDepTypes: ['pnpm.catalog.vite6'],
-      major: {
-        enabled: false,
-      },
-    },
   ],
   ignoreDeps: ['lee-dohm/no-response', 'node', 'pnpm', 'typescript'],
   schedule: ['every 4 weeks on friday'],

.github/workflows/pkg-pr-new.yml

@@ -28,4 +28,4 @@ jobs:
         run: pnpm build
 
       - name: Publish
-        run: pnpm dlx pkg-pr-new publish --no-template --pnpm './packages/*' './frameworks/*'
+        run: pnpm dlx pkg-pr-new publish --no-template --pnpm './packages/*' './frameworks/*' './frameworks-plugins/*'

.github/workflows/release.yml

@@ -6,9 +6,6 @@ on:
       dryrun:
         type: boolean
         description: Dry-Run
-      graduate:
-        type: boolean
-        description: Force Conventional Graduate
       tag:
         type: choice
         default: latest
@@ -73,20 +70,19 @@ jobs:
       - name: Lerna Version (build query)
         shell: bash
         run: |
-          if ${{inputs.dryrun == true && inputs.graduate != true}}
+          if ${{inputs.dryrun == true && (inputs.tag == 'alpha' || inputs.tag == 'beta' || inputs.tag == 'next')}}
+          then
+              echo "LERNA_VERSION_TYPE=🧪 Dry-Run w/Prerelease" >> $GITHUB_ENV
+              echo "LERNA_VERSION_QUERY=lerna version --yes --conventional-prerelease --preid ${{ inputs.tag }} --dry-run" >> $GITHUB_ENV
+          elif ${{inputs.dryrun == true}}
           then
               echo "LERNA_VERSION_TYPE=🧪 Dry-Run" >> $GITHUB_ENV
               echo "LERNA_VERSION_QUERY=lerna version --yes --dry-run" >> $GITHUB_ENV
-          elif ${{inputs.dryrun == true && inputs.graduate == true}}
-          then
-              echo "LERNA_VERSION_TYPE=🧪 Dry-Run w/Graduate" >> $GITHUB_ENV
-              echo "LERNA_VERSION_QUERY=lerna version --yes --dry-run --conventional-graduate" >> $GITHUB_ENV
-          elif ${{inputs.dryrun != true && inputs.graduate == true}}
-          then
-              echo "LERNA_VERSION_TYPE=🚀 Prod Version w/Graduate" >> $GITHUB_ENV
-              echo "LERNA_VERSION_QUERY=lerna version --yes --conventional-graduate" >> $GITHUB_ENV
-          elif ${{inputs.dryrun != true && inputs.graduate != true}}
+          elif ${{inputs.tag == 'alpha' || inputs.tag == 'beta' || inputs.tag == 'next'}}
           then
+              echo "LERNA_VERSION_TYPE=🚀 Prod Version w/Prerelease" >> $GITHUB_ENV
+              echo "LERNA_VERSION_QUERY=lerna version --yes --conventional-prerelease --preid ${{ inputs.tag }}" >> $GITHUB_ENV
+          else
               echo "LERNA_VERSION_TYPE=🚀 Prod Version" >> $GITHUB_ENV
               echo "LERNA_VERSION_QUERY=lerna version --yes" >> $GITHUB_ENV
           fi
@@ -104,13 +100,36 @@ jobs:
           git config --global user.email "${{ github.actor }}@users.noreply.github.com"
           pnpm exec ${{ env.LERNA_VERSION_QUERY }}
 
+      - name: Lerna Publish (build query)
+        shell: bash
+        run: |
+          if ${{inputs.dryrun == true && (inputs.tag == 'alpha' || inputs.tag == 'beta' || inputs.tag == 'next')}}
+          then
+            echo "LERNA_PUBLISH_TYPE=🧪 Dry-Run w/Prerelease" >> $GITHUB_ENV
+            echo "LERNA_PUBLISH_QUERY=lerna publish from-package --force-publish --yes --pre-dist-tag ${{ inputs.tag }} --dry-run" >> $GITHUB_ENV
+          elif ${{inputs.dryrun == true}}
+          then
+            echo "LERNA_PUBLISH_TYPE=🧪 Dry-Run" >> $GITHUB_ENV
+            echo "LERNA_PUBLISH_QUERY=lerna publish from-package --force-publish --yes --dist-tag latest --dry-run" >> $GITHUB_ENV
+          elif [[ "${{ inputs.tag }}" == "alpha" || "${{ inputs.tag }}" == "beta" || "${{ inputs.tag }}" == "next" ]]
+          then
+            echo "LERNA_PUBLISH_TYPE=📦 Publish w/Prerelease" >> $GITHUB_ENV
+            echo "LERNA_PUBLISH_QUERY=lerna publish from-package --force-publish --yes --pre-dist-tag ${{ inputs.tag }}" >> $GITHUB_ENV
+          else
+            echo "LERNA_PUBLISH_TYPE=📦 Publish Latest" >> $GITHUB_ENV
+            echo "LERNA_PUBLISH_QUERY=lerna publish from-package --force-publish --yes --dist-tag latest" >> $GITHUB_ENV
+          fi
+
+      - name: Final publish type → ${{ env.LERNA_PUBLISH_TYPE }}
+        shell: bash
+        run: echo "${{ env.LERNA_PUBLISH_QUERY }}"
+
       - name: Lerna Publish 📦
-        if: ${{ inputs.dryrun != true }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         id: lerna-publish
-        run: pnpm exec lerna publish from-package --force-publish --yes --dist-tag ${{ inputs.tag || 'latest' }}
+        run: pnpm exec ${{ env.LERNA_PUBLISH_QUERY }}
 
       - name: Website Dev Build
         run: pnpm build:dev

.github/workflows/test-angular.yml

@@ -70,27 +70,23 @@ jobs:
       - name: Angular-Slickgrid Framework Build
         run: pnpm angular:build:framework
 
+      - name: Angular-Slickgrid Framework-Plugins Build
+        run: pnpm angular:build:framework-plugins
+
       - name: Website Dev Build (served for Cypress)
         run: pnpm angular:build:demo
 
-      - name: Cache Cypress binary
-        uses: actions/cache@v5
-        with:
-          path: ~/.cache/Cypress
-          key: ${{ runner.os }}-cypress-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-cypress-
-
       - name: Ensure Cypress binary is installed
         run: pnpm exec cypress install
 
       - name: Start HTTP Server
         run: pnpm angular:serve &
 
       - name: Run Cypress E2E tests
-        uses: cypress-io/github-action@v6
+        uses: cypress-io/github-action@v7
         with:
           install: false
+          package-manager-cache: false
           working-directory: frameworks/angular-slickgrid
           # start: pnpm angular:serve
           wait-on: 'http://localhost:4300'

.github/workflows/test-aurelia.yml

@@ -55,27 +55,23 @@ jobs:
       - name: Aurelia-Slickgrid Framework Build
         run: pnpm aurelia:build:framework
 
+      - name: Aurelia-Slickgrid Framework-Plugins Build
+        run: pnpm aurelia:build:framework-plugins
+
       - name: Website Dev Build (served for Cypress)
         run: pnpm aurelia:build:demo
 
-      - name: Cache Cypress binary
-        uses: actions/cache@v5
-        with:
-          path: ~/.cache/Cypress
-          key: ${{ runner.os }}-cypress-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-cypress-
-
       - name: Ensure Cypress binary is installed
         run: pnpm exec cypress install
 
       - name: Start HTTP Server
         run: pnpm aurelia:serve &
 
       - name: Run Cypress E2E tests
-        uses: cypress-io/github-action@v6
+        uses: cypress-io/github-action@v7
         with:
           install: false
+          package-manager-cache: false
           working-directory: demos/aurelia
           # start: pnpm aurelia:serve
           wait-on: 'http://localhost:7900'

.github/workflows/test-react.yml

@@ -55,27 +55,23 @@ jobs:
       - name: Slickgrid-React Framework Build
         run: pnpm react:build:framework
 
+      - name: Slickgrid-React Framework-Plugins Build
+        run: pnpm react:build:framework-plugins
+
       - name: Website Dev Build (served for Cypress)
         run: pnpm react:build:demo
 
-      - name: Cache Cypress binary
-        uses: actions/cache@v5
-        with:
-          path: ~/.cache/Cypress
-          key: ${{ runner.os }}-cypress-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-cypress-
-
       - name: Ensure Cypress binary is installed
         run: pnpm exec cypress install
 
       - name: Start HTTP Server
         run: pnpm react:serve &
 
       - name: Run Cypress E2E tests
-        uses: cypress-io/github-action@v6
+        uses: cypress-io/github-action@v7
         with:
           install: false
+          package-manager-cache: false
           working-directory: demos/react
           wait-on: 'http://localhost:8000'
           config-file: test/cypress.config.ts

.github/workflows/test-vanilla.yml

@@ -55,24 +55,17 @@ jobs:
       - name: Website Dev Build (served for Cypress)
         run: pnpm build:dev
 
-      - name: Cache Cypress binary
-        uses: actions/cache@v5
-        with:
-          path: ~/.cache/Cypress
-          key: ${{ runner.os }}-cypress-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-cypress-
-
       - name: Ensure Cypress binary is installed
         run: pnpm exec cypress install
 
       - name: Start HTTP Server
         run: pnpm vanilla:serve:demo &
 
       - name: Run Cypress E2E tests
-        uses: cypress-io/github-action@v6
+        uses: cypress-io/github-action@v7
         with:
           install: false
+          package-manager-cache: false
           # working-directory: packages/dnd
           # start: pnpm vanilla:serve:demo
           # start: pnpm serve:vite

.github/workflows/test-vue.yml

@@ -55,27 +55,23 @@ jobs:
       - name: Slickgrid-Vue Framework Build
         run: pnpm vue:build:framework
 
+      - name: Slickgrid-Vue Framework-Plugins Build
+        run: pnpm vue:build:framework-plugins
+
       - name: Website Dev Build (served for Cypress)
         run: pnpm vue:build:demo
 
-      - name: Cache Cypress binary
-        uses: actions/cache@v5
-        with:
-          path: ~/.cache/Cypress
-          key: ${{ runner.os }}-cypress-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-cypress-
-
       - name: Ensure Cypress binary is installed
         run: pnpm exec cypress install
 
       - name: Start HTTP Server
         run: pnpm vue:serve &
 
       - name: Run Cypress E2E tests
-        uses: cypress-io/github-action@v6
+        uses: cypress-io/github-action@v7
         with:
           install: false
+          package-manager-cache: false
           working-directory: demos/vue
           # start: pnpm vue:serve
           wait-on: 'http://localhost:7000'

.prettierignore

@@ -2,4 +2,6 @@
 _variables.scss
 _variables-theme-material.scss
 _variables-theme-salesforce.scss
-**/test/vitest-coverage/*.*
+**/test/vitest-coverage/*.*
+demos/vue/src/router/index.ts
+demos/react/src/examples/slickgrid/App.tsx

.vscode/settings.json

@@ -7,5 +7,7 @@
   ],
   "typescript.format.semicolons": "insert",
   "vitest.rootConfig": "./test/vitest.config.mts",
-  "typescript.tsdk": "node_modules\\typescript\\lib"
+  "typescript.tsdk": "node_modules\\typescript\\lib",
+  "prettier.prettierPath": "node_modules/prettier/index.cjs",
+  "prettier.configPath": ".prettierrc"
 }