diff --git a/.agents/skills/link-workspace-packages/SKILL.md b/.agents/skills/link-workspace-packages/SKILL.md new file mode 100644 index 00000000000..de1313497a3 --- /dev/null +++ b/.agents/skills/link-workspace-packages/SKILL.md @@ -0,0 +1,127 @@ +--- +name: link-workspace-packages +description: 'Link workspace packages in monorepos (npm, yarn, pnpm, bun). USE WHEN: (1) you just created or generated new packages and need to wire up their dependencies, (2) user imports from a sibling package and needs to add it as a dependency, (3) you get resolution errors for workspace packages (@org/*) like "cannot find module", "failed to resolve import", "TS2307", or "cannot resolve". DO NOT patch around with tsconfig paths or manual package.json edits - use the package manager''s workspace commands to fix actual linking.' +--- + +# Link Workspace Packages + +Add dependencies between packages in a monorepo. All package managers support workspaces but with different syntax. + +## Detect Package Manager + +Check whether there's a `packageManager` field in the root-level `package.json`. + +Alternatively check lockfile in repo root: + +- `pnpm-lock.yaml` → pnpm +- `yarn.lock` → yarn +- `bun.lock` / `bun.lockb` → bun +- `package-lock.json` → npm + +## Workflow + +1. Identify consumer package (the one importing) +2. Identify provider package(s) (being imported) +3. Add dependency using package manager's workspace syntax +4. Verify symlinks created in consumer's `node_modules/` + +--- + +## pnpm + +Uses `workspace:` protocol - symlinks only created when explicitly declared. + +```bash +# From consumer directory +pnpm add @org/ui --workspace + +# Or with --filter from anywhere +pnpm add @org/ui --filter @org/app --workspace +``` + +Result in `package.json`: + +```json +{ "dependencies": { "@org/ui": "workspace:*" } } +``` + +--- + +## yarn (v2+/berry) + +Also uses `workspace:` protocol. + +```bash +yarn workspace @org/app add @org/ui +``` + +Result in `package.json`: + +```json +{ "dependencies": { "@org/ui": "workspace:^" } } +``` + +--- + +## npm + +No `workspace:` protocol. npm auto-symlinks workspace packages. + +```bash +npm install @org/ui --workspace @org/app +``` + +Result in `package.json`: + +```json +{ "dependencies": { "@org/ui": "*" } } +``` + +npm resolves to local workspace automatically during install. + +--- + +## bun + +Supports `workspace:` protocol (pnpm-compatible). + +```bash +cd packages/app && bun add @org/ui +``` + +Result in `package.json`: + +```json +{ "dependencies": { "@org/ui": "workspace:*" } } +``` + +--- + +## Examples + +**Example 1: pnpm - link ui lib to app** + +```bash +pnpm add @org/ui --filter @org/app --workspace +``` + +**Example 2: npm - link multiple packages** + +```bash +npm install @org/data-access @org/ui --workspace @org/dashboard +``` + +**Example 3: Debug "Cannot find module"** + +1. Check if dependency is declared in consumer's `package.json` +2. If not, add it using appropriate command above +3. Run install (`pnpm install`, `npm install`, etc.) + +## Notes + +- Symlinks appear in `/node_modules/@org/` +- **Hoisting differs by manager:** + - npm/bun: hoist shared deps to root `node_modules` + - pnpm: no hoisting (strict isolation, prevents phantom deps) + - yarn berry: uses Plug'n'Play by default (no `node_modules`) +- Root `package.json` should have `"private": true` to prevent accidental publish diff --git a/.agents/skills/monitor-ci/SKILL.md b/.agents/skills/monitor-ci/SKILL.md new file mode 100644 index 00000000000..a4af6cbb556 --- /dev/null +++ b/.agents/skills/monitor-ci/SKILL.md @@ -0,0 +1,301 @@ +--- +name: monitor-ci +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. +--- + +# Monitor CI Command + +You are the orchestrator for monitoring Nx Cloud CI pipeline executions and handling self-healing fixes. You spawn subagents to interact with Nx Cloud, run deterministic decision scripts, and take action based on the results. + +## Context + +- **Current Branch:** !`git branch --show-current` +- **Current Commit:** !`git rev-parse --short HEAD` +- **Remote Status:** !`git status -sb | head -1` + +## User Instructions + +$ARGUMENTS + +**Important:** If user provides specific instructions, respect them over default behaviors described below. + +## Configuration Defaults + +| Setting | Default | Description | +| ------------------------- | ------------- | ------------------------------------------------------------------------- | +| `--max-cycles` | 10 | Maximum **agent-initiated** CI Attempt cycles before timeout | +| `--timeout` | 120 | Maximum duration in minutes | +| `--verbosity` | medium | Output level: minimal, medium, verbose | +| `--branch` | (auto-detect) | Branch to monitor | +| `--fresh` | false | Ignore previous context, start fresh | +| `--auto-fix-workflow` | false | Attempt common fixes for pre-CI-Attempt failures (e.g., lockfile updates) | +| `--new-cipe-timeout` | 10 | Minutes to wait for new CI Attempt after action | +| `--local-verify-attempts` | 3 | Max local verification + enhance cycles before pushing to CI | + +Parse any overrides from `$ARGUMENTS` and merge with defaults. + +## Nx Cloud Connection Check + +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. + +### Step 0: Verify Nx Cloud Connection + +1. **Check `nx.json`** at workspace root for `nxCloudId` or `nxCloudAccessToken` +2. **If `nx.json` missing OR neither property exists** → exit with: + + ``` + Nx Cloud not connected. Unlock 70% faster CI and auto-fix broken PRs with https://nx.dev/nx-cloud + ``` + +3. **If connected** → continue to main loop + +## Architecture Overview + +1. **This skill (orchestrator)**: spawns subagents, runs scripts, prints status, does local coding work +2. **ci-monitor-subagent (haiku)**: calls one MCP tool (ci_information or update_self_healing_fix), returns structured result, exits +3. **ci-poll-decide.mjs (deterministic script)**: takes ci_information result + state, returns action + status message +4. **ci-state-update.mjs (deterministic script)**: manages budget gates, post-action state transitions, and cycle classification + +## Status Reporting + +The decision script handles message formatting based on verbosity. When printing messages to the user: + +- Prepend `[monitor-ci]` to every message from the script's `message` field +- For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` + +## Anti-Patterns + +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: + +| Anti-Pattern | Why It's Bad | +| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | +| Using CI provider CLIs with `--watch` flags (e.g., `gh pr checks --watch`, `glab ci status -w`) | Bypasses Nx Cloud self-healing entirely | +| Writing custom CI polling scripts | Unreliable, pollutes context, no self-healing | +| Cancelling CI workflows/pipelines | Destructive, loses CI progress | +| Running CI checks on main agent | Wastes main agent context tokens | +| Independently analyzing/fixing CI failures while polling | Races with self-healing, causes duplicate fixes and confused state | + +**If this skill fails to activate**, the fallback is: + +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) +2. Immediately delegate to this skill with gathered context +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing + +## Session Context Behavior + +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. + +## MCP Tool Reference + +Three field sets control polling efficiency — use the lightest set that gives you what you need: + +```yaml +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` + +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). + +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. + +## Default Behaviors by Status + +The decision script returns one of the following statuses. This table defines the **default behavior** for each. User instructions can override any of these. + +**Simple exits** — just report and exit: + +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit + +## Main Loop + +### Step 1: Initialize Tracking + +``` +cycle_count = 0 # Only incremented for agent-initiated cycles (counted against --max-cycles) +start_time = now() +no_progress_count = 0 +local_verify_count = 0 +env_rerun_count = 0 +last_cipe_url = null +expected_commit_sha = null +agent_triggered = false # Set true after monitor takes an action that triggers new CI Attempt +poll_count = 0 +wait_mode = false +prev_status = null +prev_cipe_status = null +prev_sh_status = null +prev_verification_status = null +prev_failure_classification = null +``` + +### Step 2: Polling Loop + +Repeat until done: + +#### 2a. Spawn subagent (FETCH_STATUS) + +Determine select fields based on mode: + +- **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) +- **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS + +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. + +#### 2b. Run decision script + +```bash +node /scripts/ci-poll-decide.mjs '' \ + [--wait-mode] \ + [--prev-cipe-url ] \ + [--expected-sha ] \ + [--prev-status ] \ + [--timeout ] \ + [--new-cipe-timeout ] \ + [--env-rerun-count ] \ + [--no-progress-count ] \ + [--prev-cipe-status ] \ + [--prev-sh-status ] \ + [--prev-verification-status ] \ + [--prev-failure-classification ] +``` + +The script outputs a single JSON line: `{ action, code, message, delay?, noProgressCount, envRerunCount, fields?, newCipeDetected?, verifiableTaskIds? }` + +#### 2c. Process script output + +Parse the JSON output and update tracking state: + +- `no_progress_count = output.noProgressCount` +- `env_rerun_count = output.envRerunCount` +- `prev_cipe_status = subagent_result.cipeStatus` +- `prev_sh_status = subagent_result.selfHealingStatus` +- `prev_verification_status = subagent_result.verificationStatus` +- `prev_failure_classification = subagent_result.failureClassification` +- `prev_status = output.action + ":" + (output.code || subagent_result.cipeStatus)` +- `poll_count++` + +Based on `action`: + +- **`action == "poll"`**: Print `output.message`, sleep `output.delay` seconds, go to 2a + - If `output.newCipeDetected`: clear wait mode, reset `wait_mode = false` +- **`action == "wait"`**: Print `output.message`, sleep `output.delay` seconds, go to 2a +- **`action == "done"`**: Proceed to Step 3 with `output.code` + +### Step 3: Handle Actionable Status + +When decision script returns `action == "done"`: + +1. Run cycle-check (Step 4) **before** handling the code +2. Check the returned `code` +3. Look up default behavior in the table above +4. Check if user instructions override the default +5. Execute the appropriate action +6. **If action expects new CI Attempt**, update tracking (see Step 3a) +7. If action results in looping, go to Step 2 + +#### Tool calls for actions + +Several statuses require fetching additional data or calling tools: + +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix + +### Step 3a: Track State for New-CI-Attempt Detection + +After actions that should trigger a new CI Attempt, run: + +```bash +node /scripts/ci-state-update.mjs post-action \ + --action \ + --cipe-url \ + --commit-sha +``` + +Action types: `fix-auto-applying`, `apply-mcp`, `apply-local-push`, `reject-fix-push`, `local-fix-push`, `env-rerun`, `auto-fix-push`, `empty-commit-push` + +The script returns `{ waitMode, pollCount, lastCipeUrl, expectedCommitSha, agentTriggered }`. Update all tracking state from the output, then go to Step 2. + +### Step 4: Cycle Classification and Progress Tracking + +When the decision script returns `action == "done"`, run cycle-check **before** handling the code: + +```bash +node /scripts/ci-state-update.mjs cycle-check \ + --code \ + [--agent-triggered] \ + --cycle-count --max-cycles \ + --env-rerun-count +``` + +The script returns `{ cycleCount, agentTriggered, envRerunCount, approachingLimit, message }`. Update tracking state from the output. + +- If `approachingLimit` → ask user whether to continue (with 5 or 10 more cycles) or stop monitoring +- If previous cycle was NOT agent-triggered (human pushed), log that human-initiated push was detected + +#### Progress Tracking + +- `no_progress_count`, circuit breaker (5 polls), and backoff reset are handled by ci-poll-decide.mjs (progress = any change in cipeStatus, selfHealingStatus, verificationStatus, or failureClassification) +- `env_rerun_count` reset on non-environment status is handled by ci-state-update.mjs cycle-check +- On new CI Attempt detected (poll script returns `newCipeDetected`) → reset `local_verify_count = 0`, `env_rerun_count = 0` + +## Error Handling + +| Error | Action | +| ------------------------------ | ----------------------------------------------------------------------------------------------------------- | +| Git rebase conflict | Report to user, exit | +| `nx-cloud apply-locally` fails | Reject fix via MCP (`action: "REJECT"`), then attempt manual patch (Reject + Fix From Scratch Flow) or exit | +| MCP tool error | Retry once, if fails report to user | +| Subagent spawn failure | Retry once, if fails exit with error | +| Decision script error | Treat as `error` status, increment `no_progress_count` | +| No new CI Attempt detected | If `--auto-fix-workflow`, try lockfile update; otherwise report to user with guidance | +| Lockfile auto-fix fails | Report to user, exit with guidance to check CI logs | + +## User Instruction Examples + +Users can override default behaviors: + +| Instruction | Effect | +| ------------------------------------------------ | --------------------------------------------------- | +| "never auto-apply" | Always prompt before applying any fix | +| "always ask before git push" | Prompt before each push | +| "reject any fix for e2e tasks" | Auto-reject if `failedTaskIds` contains e2e | +| "apply all fixes regardless of verification" | Skip verification check, apply everything | +| "if confidence < 70, reject" | Check confidence field before applying | +| "run 'nx affected -t typecheck' before applying" | Add local verification step | +| "auto-fix workflow failures" | Attempt lockfile updates on pre-CI-Attempt failures | +| "wait 45 min for new CI Attempt" | Override new-CI-Attempt timeout (default: 10 min) | diff --git a/.agents/skills/monitor-ci/references/fix-flows.md b/.agents/skills/monitor-ci/references/fix-flows.md new file mode 100644 index 00000000000..b33aa02167b --- /dev/null +++ b/.agents/skills/monitor-ci/references/fix-flows.md @@ -0,0 +1,108 @@ +# Detailed Status Handling & Fix Flows + +## Status Handling by Code + +### fix_auto_apply_skipped + +The script returns `autoApplySkipReason` in its output. + +1. Report the skip reason to the user (e.g., "Auto-apply was skipped because the previous CI pipeline execution was triggered by Nx Cloud") +2. Offer to apply the fix manually — spawn UPDATE_FIX subagent with `APPLY` if user agrees +3. Record `last_cipe_url`, enter wait mode + +### fix_apply_ready + +- Spawn UPDATE_FIX subagent with `APPLY` +- Record `last_cipe_url`, enter wait mode + +### fix_needs_local_verify + +The script returns `verifiableTaskIds` in its output. + +1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` +2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task +3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode +4. **If any fail** → Apply Locally + Enhance Flow (see below) + +### fix_needs_review + +Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): + +- If fix looks correct → apply via MCP +- If fix needs enhancement → Apply Locally + Enhance Flow +- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow + +### fix_failed / no_fix + +Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. + +### environment_issue + +1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` +3. Enter wait mode with `last_cipe_url` set + +### self_healing_throttled + +Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. + +1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) +2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` +3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. +4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode + +### no_new_cipe + +1. Report to user: no CI attempt found, suggest checking CI provider +2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode +3. Otherwise: exit with guidance + +### cipe_no_tasks + +1. Report to user: CI failed with no tasks recorded +2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode +3. If retry also returns `cipe_no_tasks`: exit with failure + +## Fix Action Flows + +### Apply via MCP + +Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. + +### Apply Locally + Enhance Flow + +1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) +2. Enhance code to fix failing tasks +3. Run failing tasks to verify +4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. +5. If passing → commit and push, enter wait mode + +### Reject + Fix From Scratch Flow + +1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `REJECT` +3. Fix from scratch locally +4. Commit and push, enter wait mode + +## Environment vs Code Failure Recognition + +When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. + +**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. + +When detected → bail immediately without running gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. + +**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. + +## Git Safety + +- Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets + +## Commit Message Format + +```bash +git commit -m "fix(): + +Failed tasks: , +Local verification: passed|enhanced|failed-pushing-to-ci" +``` diff --git a/.agents/skills/monitor-ci/scripts/ci-poll-decide.mjs b/.agents/skills/monitor-ci/scripts/ci-poll-decide.mjs new file mode 100644 index 00000000000..5a296493320 --- /dev/null +++ b/.agents/skills/monitor-ci/scripts/ci-poll-decide.mjs @@ -0,0 +1,384 @@ +#!/usr/bin/env node + +/** + * CI Poll Decision Script + * + * Deterministic decision engine for CI monitoring. + * Takes ci_information JSON + state args, outputs a single JSON action line. + * + * Architecture: + * classify() — pure decision tree, returns { action, code, extra? } + * buildOutput() — maps classification to full output with messages, delays, counters + * + * Usage: + * node ci-poll-decide.mjs '' \ + * [--wait-mode] [--prev-cipe-url ] [--expected-sha ] \ + * [--prev-status ] [--timeout ] [--new-cipe-timeout ] \ + * [--env-rerun-count ] [--no-progress-count ] \ + * [--prev-cipe-status ] [--prev-sh-status ] \ + * [--prev-verification-status ] [--prev-failure-classification ] + */ + +// --- Arg parsing --- + +const args = process.argv.slice(2); +const ciInfoJson = args[0]; +const pollCount = parseInt(args[1], 10) || 0; +const verbosity = args[2] || "medium"; + +function getFlag(name) { + return args.includes(name); +} + +function getArg(name) { + const idx = args.indexOf(name); + return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : null; +} + +const waitMode = getFlag("--wait-mode"); +const prevCipeUrl = getArg("--prev-cipe-url"); +const expectedSha = getArg("--expected-sha"); +const prevStatus = getArg("--prev-status"); +const timeoutSeconds = parseInt(getArg("--timeout") || "0", 10); +const newCipeTimeoutSeconds = parseInt(getArg("--new-cipe-timeout") || "0", 10); +const envRerunCount = parseInt(getArg("--env-rerun-count") || "0", 10); +const inputNoProgressCount = parseInt(getArg("--no-progress-count") || "0", 10); +const prevCipeStatus = getArg("--prev-cipe-status"); +const prevShStatus = getArg("--prev-sh-status"); +const prevVerificationStatus = getArg("--prev-verification-status"); +const prevFailureClassification = getArg("--prev-failure-classification"); + +// --- Parse CI info --- + +let ci; +try { + ci = JSON.parse(ciInfoJson); +} catch { + console.log( + JSON.stringify({ + action: "done", + code: "error", + message: "Failed to parse ci_information JSON", + noProgressCount: inputNoProgressCount + 1, + envRerunCount, + }), + ); + process.exit(0); +} + +const { + cipeStatus, + selfHealingStatus, + verificationStatus, + selfHealingEnabled, + selfHealingSkippedReason, + failureClassification: rawFailureClassification, + failedTaskIds = [], + verifiedTaskIds = [], + couldAutoApplyTasks, + autoApplySkipped, + autoApplySkipReason, + userAction, + cipeUrl, + commitSha, +} = ci; + +const failureClassification = rawFailureClassification?.toLowerCase() ?? null; + +// --- Helpers --- + +function categorizeTasks() { + const verifiedSet = new Set(verifiedTaskIds); + const unverified = failedTaskIds.filter((t) => !verifiedSet.has(t)); + if (unverified.length === 0) return { category: "all_verified" }; + + const e2e = unverified.filter((t) => { + const parts = t.split(":"); + return parts.length >= 2 && parts[1].includes("e2e"); + }); + if (e2e.length === unverified.length) return { category: "e2e_only" }; + + const verifiable = unverified.filter((t) => { + const parts = t.split(":"); + return !(parts.length >= 2 && parts[1].includes("e2e")); + }); + return { category: "needs_local_verify", verifiableTaskIds: verifiable }; +} + +function backoff(count) { + const delays = [60, 90, 120]; + return delays[Math.min(count, delays.length - 1)]; +} + +function hasStateChanged() { + if (prevCipeStatus && cipeStatus !== prevCipeStatus) return true; + if (prevShStatus && selfHealingStatus !== prevShStatus) return true; + if (prevVerificationStatus && verificationStatus !== prevVerificationStatus) return true; + if (prevFailureClassification && failureClassification !== prevFailureClassification) return true; + return false; +} + +function isTimedOut() { + if (timeoutSeconds <= 0) return false; + const avgDelay = pollCount === 0 ? 0 : backoff(Math.floor(pollCount / 2)); + return pollCount * avgDelay >= timeoutSeconds; +} + +function isWaitTimedOut() { + if (newCipeTimeoutSeconds <= 0) return false; + return pollCount * 30 >= newCipeTimeoutSeconds; +} + +function isNewCipe() { + return (prevCipeUrl && cipeUrl && cipeUrl !== prevCipeUrl) || (expectedSha && commitSha && commitSha === expectedSha); +} + +// ============================================================ +// classify() — pure decision tree +// +// Returns: { action: 'poll'|'wait'|'done', code: string, extra? } +// +// Decision priority (top wins): +// WAIT MODE: +// 1. new CI Attempt detected → poll (new_cipe_detected) +// 2. wait timed out → done (no_new_cipe) +// 3. still waiting → wait (waiting_for_cipe) +// NORMAL MODE: +// 4. polling timeout → done (polling_timeout) +// 5. circuit breaker (5 polls) → done (circuit_breaker) +// 6. CI succeeded → done (ci_success) +// 7. CI canceled → done (cipe_canceled) +// 8. CI timed out → done (cipe_timed_out) +// 9. CI failed, no tasks recorded → done (cipe_no_tasks) +// 10. environment failure → done (environment_rerun_cap | environment_issue) +// 11. self-healing throttled → done (self_healing_throttled) +// 12. CI in progress / not started → poll (ci_running) +// 13. self-healing in progress → poll (sh_running) +// 14. flaky task auto-rerun → poll (flaky_rerun) +// 15. fix auto-applied → poll (fix_auto_applied) +// 16. auto-apply: skipped → done (fix_auto_apply_skipped) +// 17. auto-apply: verification pending→ poll (verification_pending) +// 18. auto-apply: verified → done (fix_auto_applying) +// 19. fix: verification failed/none → done (fix_needs_review) +// 20. fix: all/e2e verified → done (fix_apply_ready) +// 21. fix: needs local verify → done (fix_needs_local_verify) +// 22. self-healing failed → done (fix_failed) +// 23. no fix available → done (no_fix) +// 24. fallback → poll (fallback) +// ============================================================ + +function classify() { + // --- Wait mode --- + if (waitMode) { + if (isNewCipe()) return { action: "poll", code: "new_cipe_detected" }; + if (isWaitTimedOut()) return { action: "done", code: "no_new_cipe" }; + return { action: "wait", code: "waiting_for_cipe" }; + } + + // --- Guards --- + if (isTimedOut()) return { action: "done", code: "polling_timeout" }; + if (noProgressCount >= 5) return { action: "done", code: "circuit_breaker" }; + + // --- Terminal CI states --- + if (cipeStatus === "SUCCEEDED") return { action: "done", code: "ci_success" }; + if (cipeStatus === "CANCELED") return { action: "done", code: "cipe_canceled" }; + if (cipeStatus === "TIMED_OUT") return { action: "done", code: "cipe_timed_out" }; + + // --- CI failed, no tasks --- + if (cipeStatus === "FAILED" && failedTaskIds.length === 0 && selfHealingStatus == null) + return { action: "done", code: "cipe_no_tasks" }; + + // --- Environment failure --- + if (failureClassification === "environment_state") { + if (envRerunCount >= 2) return { action: "done", code: "environment_rerun_cap" }; + return { action: "done", code: "environment_issue" }; + } + + // --- Throttled --- + if (selfHealingSkippedReason === "THROTTLED") return { action: "done", code: "self_healing_throttled" }; + + // --- Still running: CI --- + if (cipeStatus === "IN_PROGRESS" || cipeStatus === "NOT_STARTED") return { action: "poll", code: "ci_running" }; + + // --- Still running: self-healing --- + if ((selfHealingStatus === "IN_PROGRESS" || selfHealingStatus === "NOT_STARTED") && !selfHealingSkippedReason) + return { action: "poll", code: "sh_running" }; + + // --- Still running: flaky rerun --- + if (failureClassification === "flaky_task") return { action: "poll", code: "flaky_rerun" }; + + // --- Fix auto-applied, waiting for new CI Attempt --- + if (userAction === "APPLIED_AUTOMATICALLY") return { action: "poll", code: "fix_auto_applied" }; + + // --- Auto-apply path (couldAutoApplyTasks) --- + if (couldAutoApplyTasks === true) { + if (autoApplySkipped === true) + return { + action: "done", + code: "fix_auto_apply_skipped", + extra: { autoApplySkipReason }, + }; + if (verificationStatus === "NOT_STARTED" || verificationStatus === "IN_PROGRESS") + return { action: "poll", code: "verification_pending" }; + if (verificationStatus === "COMPLETED") return { action: "done", code: "fix_auto_applying" }; + // verification FAILED or NOT_EXECUTABLE → falls through to fix_needs_review + } + + // --- Fix available --- + if (selfHealingStatus === "COMPLETED") { + if ( + verificationStatus === "FAILED" || + verificationStatus === "NOT_EXECUTABLE" || + (couldAutoApplyTasks !== true && !verificationStatus) + ) + return { action: "done", code: "fix_needs_review" }; + + const tasks = categorizeTasks(); + if (tasks.category === "all_verified" || tasks.category === "e2e_only") + return { action: "done", code: "fix_apply_ready" }; + return { + action: "done", + code: "fix_needs_local_verify", + extra: { verifiableTaskIds: tasks.verifiableTaskIds }, + }; + } + + // --- Fix failed --- + if (selfHealingStatus === "FAILED") return { action: "done", code: "fix_failed" }; + + // --- No fix available --- + if (cipeStatus === "FAILED" && (selfHealingEnabled === false || selfHealingStatus === "NOT_EXECUTABLE")) + return { action: "done", code: "no_fix" }; + + // --- Fallback --- + return { action: "poll", code: "fallback" }; +} + +// ============================================================ +// buildOutput() — maps classification to full JSON output +// ============================================================ + +// Message templates keyed by status or key +const messages = { + // wait mode + new_cipe_detected: () => `New CI Attempt detected! CI: ${cipeStatus || "N/A"}`, + no_new_cipe: () => "New CI Attempt timeout exceeded. No new CI Attempt detected.", + waiting_for_cipe: () => "Waiting for new CI Attempt...", + + // guards + polling_timeout: () => "Polling timeout exceeded.", + circuit_breaker: () => "No progress after 5 consecutive polls. Stopping.", + + // terminal + ci_success: () => "CI passed successfully!", + cipe_canceled: () => "CI Attempt was canceled.", + cipe_timed_out: () => "CI Attempt timed out.", + cipe_no_tasks: () => "CI failed but no Nx tasks were recorded.", + + // environment + environment_rerun_cap: () => "Environment rerun cap (2) exceeded. Bailing.", + environment_issue: () => "CI: FAILED | Classification: ENVIRONMENT_STATE", + + // throttled + self_healing_throttled: () => "Self-healing throttled \u2014 too many unapplied fixes.", + + // polling + ci_running: () => `CI: ${cipeStatus}`, + sh_running: () => `CI: ${cipeStatus} | Self-healing: ${selfHealingStatus}`, + flaky_rerun: () => "CI: FAILED | Classification: FLAKY_TASK (auto-rerun in progress)", + fix_auto_applied: () => "CI: FAILED | Fix auto-applied, new CI Attempt spawning", + verification_pending: () => `CI: FAILED | Self-healing: COMPLETED | Verification: ${verificationStatus}`, + + // actionable + fix_auto_applying: () => "Fix verified! Auto-applying...", + fix_auto_apply_skipped: (extra) => + `Fix verified but auto-apply was skipped. ${ + extra?.autoApplySkipReason ? `Reason: ${extra.autoApplySkipReason}` : "Offer to apply manually." + }`, + fix_needs_review: () => `Fix available but needs review. Verification: ${verificationStatus || "N/A"}`, + fix_apply_ready: () => "Fix available and verified. Ready to apply.", + fix_needs_local_verify: (extra) => + `Fix available. ${extra.verifiableTaskIds.length} task(s) need local verification.`, + fix_failed: () => "Self-healing failed to generate a fix.", + no_fix: () => "CI failed, no fix available.", + + // fallback + fallback: () => + `CI: ${cipeStatus || "N/A"} | Self-healing: ${ + selfHealingStatus || "N/A" + } | Verification: ${verificationStatus || "N/A"}`, +}; + +// Codes where noProgressCount resets to 0 (genuine progress occurred) +const resetProgressCodes = new Set([ + "ci_success", + "fix_auto_applying", + "fix_auto_apply_skipped", + "fix_needs_review", + "fix_apply_ready", + "fix_needs_local_verify", +]); + +function formatMessage(msg) { + if (verbosity === "minimal") { + const currentStatus = `${cipeStatus}|${selfHealingStatus}|${verificationStatus}`; + if (currentStatus === (prevStatus || "")) return null; + return msg; + } + if (verbosity === "verbose") { + return [ + `Poll #${pollCount + 1} | CI: ${cipeStatus || "N/A"} | Self-healing: ${ + selfHealingStatus || "N/A" + } | Verification: ${verificationStatus || "N/A"}`, + msg, + ].join("\n"); + } + return `Poll #${pollCount + 1} | ${msg}`; +} + +function buildOutput(decision) { + const { action, code, extra } = decision; + + // noProgressCount is already computed before classify() was called. + // Here we only handle the reset for "genuine progress" done-codes. + + const msgFn = messages[code]; + const rawMsg = msgFn ? msgFn(extra) : `Unknown: ${code}`; + const message = formatMessage(rawMsg); + + const result = { + action, + code, + message, + noProgressCount: resetProgressCodes.has(code) ? 0 : noProgressCount, + envRerunCount, + }; + + // Add delay + if (action === "wait") { + result.delay = 30; + } else if (action === "poll") { + result.delay = code === "new_cipe_detected" ? 60 : backoff(noProgressCount); + result.fields = "light"; + } + + // Add extras + if (code === "new_cipe_detected") result.newCipeDetected = true; + if (extra?.verifiableTaskIds) result.verifiableTaskIds = extra.verifiableTaskIds; + if (extra?.autoApplySkipReason) result.autoApplySkipReason = extra.autoApplySkipReason; + + console.log(JSON.stringify(result)); +} + +// --- Run --- + +// Compute noProgressCount from input. Single assignment, no mutation. +// Wait mode: reset on new cipe, otherwise unchanged (wait doesn't count as no-progress). +// Normal mode: reset on any state change, otherwise increment. +const noProgressCount = (() => { + if (waitMode) return isNewCipe() ? 0 : inputNoProgressCount; + if (isNewCipe() || hasStateChanged()) return 0; + return inputNoProgressCount + 1; +})(); + +buildOutput(classify()); diff --git a/.agents/skills/monitor-ci/scripts/ci-state-update.mjs b/.agents/skills/monitor-ci/scripts/ci-state-update.mjs new file mode 100644 index 00000000000..345daa0c7df --- /dev/null +++ b/.agents/skills/monitor-ci/scripts/ci-state-update.mjs @@ -0,0 +1,158 @@ +#!/usr/bin/env node + +/** + * CI State Update Script + * + * Deterministic state management for CI monitor actions. + * Three commands: gate, post-action, cycle-check. + * + * Usage: + * node ci-state-update.mjs gate --gate-type [counter args] + * node ci-state-update.mjs post-action --action [--cipe-url ] [--commit-sha ] + * node ci-state-update.mjs cycle-check --code [--agent-triggered] [counter args] + */ + +// --- Arg parsing --- + +const args = process.argv.slice(2); +const command = args[0]; + +function getFlag(name) { + return args.includes(name); +} + +function getArg(name) { + const idx = args.indexOf(name); + return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : null; +} + +function output(result) { + console.log(JSON.stringify(result)); +} + +// --- gate --- +// Check if an action is allowed and return incremented counter. +// Called before any local fix attempt or environment rerun. + +function gate() { + const gateType = getArg("--gate-type"); + + if (gateType === "local-fix") { + const count = parseInt(getArg("--local-verify-count") || "0", 10); + const max = parseInt(getArg("--local-verify-attempts") || "3", 10); + if (count >= max) { + return output({ + allowed: false, + localVerifyCount: count, + message: `Local fix budget exhausted (${count}/${max} attempts)`, + }); + } + return output({ + allowed: true, + localVerifyCount: count + 1, + message: null, + }); + } + + if (gateType === "env-rerun") { + const count = parseInt(getArg("--env-rerun-count") || "0", 10); + if (count >= 2) { + return output({ + allowed: false, + envRerunCount: count, + message: `Environment issue persists after ${count} reruns. Manual investigation needed.`, + }); + } + return output({ + allowed: true, + envRerunCount: count + 1, + message: null, + }); + } + + output({ allowed: false, message: `Unknown gate type: ${gateType}` }); +} + +// --- post-action --- +// Compute next state after an action is taken. +// Returns wait mode params and whether the action was agent-triggered. + +function postAction() { + const action = getArg("--action"); + const cipeUrl = getArg("--cipe-url"); + const commitSha = getArg("--commit-sha"); + + // MCP-triggered or auto-applied: track by cipeUrl + const cipeUrlActions = ["fix-auto-applying", "apply-mcp", "env-rerun"]; + // Local push: track by commitSha + const commitShaActions = [ + "apply-local-push", + "reject-fix-push", + "local-fix-push", + "auto-fix-push", + "empty-commit-push", + ]; + + const trackByCipeUrl = cipeUrlActions.includes(action); + const trackByCommitSha = commitShaActions.includes(action); + + if (!trackByCipeUrl && !trackByCommitSha) { + return output({ error: `Unknown action: ${action}` }); + } + + // fix-auto-applying: self-healing did it, NOT the monitor + const agentTriggered = action !== "fix-auto-applying"; + + output({ + waitMode: true, + pollCount: 0, + lastCipeUrl: trackByCipeUrl ? cipeUrl : null, + expectedCommitSha: trackByCommitSha ? commitSha : null, + agentTriggered, + }); +} + +// --- cycle-check --- +// Cycle classification + counter resets when a new "done" code is received. +// Called at the start of handling each actionable code. + +function cycleCheck() { + const status = getArg("--code"); + const wasAgentTriggered = getFlag("--agent-triggered"); + let cycleCount = parseInt(getArg("--cycle-count") || "0", 10); + const maxCycles = parseInt(getArg("--max-cycles") || "10", 10); + let envRerunCount = parseInt(getArg("--env-rerun-count") || "0", 10); + + // Cycle classification: if previous cycle was agent-triggered, count it + if (wasAgentTriggered) cycleCount++; + + // Reset env_rerun_count on non-environment status + if (status !== "environment_issue") envRerunCount = 0; + + // Approaching limit gate + const approachingLimit = cycleCount >= maxCycles - 2; + + output({ + cycleCount, + agentTriggered: false, + envRerunCount, + approachingLimit, + message: approachingLimit ? `Approaching cycle limit (${cycleCount}/${maxCycles})` : null, + }); +} + +// --- Dispatch --- + +switch (command) { + case "gate": + gate(); + break; + case "post-action": + postAction(); + break; + case "cycle-check": + cycleCheck(); + break; + default: + output({ error: `Unknown command: ${command}` }); +} diff --git a/.agents/skills/nx-generate/SKILL.md b/.agents/skills/nx-generate/SKILL.md new file mode 100644 index 00000000000..af7ba80a445 --- /dev/null +++ b/.agents/skills/nx-generate/SKILL.md @@ -0,0 +1,166 @@ +--- +name: nx-generate +description: Generate code using nx generators. INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure. Trigger words - scaffold, setup, create a ... app, create a ... lib, project structure, generate, add a new project. ALWAYS use this BEFORE calling nx_docs or exploring - this skill handles discovery internally. +--- + +# Run Nx Generator + +Nx generators are powerful tools that scaffold projects, make automated code migrations or automate repetitive tasks in a monorepo. They ensure consistency across the codebase and reduce boilerplate work. + +This skill applies when the user wants to: + +- Create new projects like libraries or applications +- Scaffold features or boilerplate code +- Run workspace-specific or custom generators +- Do anything else that an nx generator exists for + +## Key Principles + +1. **Always use `--no-interactive`** - Prevents prompts that would hang execution +2. **Read the generator source code** - The schema alone is not enough; understand what the generator actually does +3. **Match existing repo patterns** - Study similar artifacts in the repo and follow their conventions +4. **Verify with lint/test/build/typecheck etc.** - Generated code must pass verification. The listed targets are just an example, use what's appropriate for this workspace. + +## Steps + +### 1. Discover Available Generators + +Use the Nx CLI to discover available generators: + +- List all generators for a plugin: `npx nx list @nx/react` +- View available plugins: `npx nx list` + +This includes plugin generators (e.g., `@nx/react:library`) and local workspace generators. + +### 2. Match Generator to User Request + +Identify which generator(s) could fulfill the user's needs. Consider what artifact type they want, which framework is relevant, and any specific generator names mentioned. + +**IMPORTANT**: When both a local workspace generator and an external plugin generator could satisfy the request, **always prefer the local workspace generator**. Local generators are customized for the specific repo's patterns. + +If no suitable generator exists, you can stop using this skill. However, the burden of proof is high—carefully consider all available generators before deciding none apply. + +### 3. Get Generator Options + +Use the `--help` flag to understand available options: + +```bash +npx nx g @nx/react:library --help +``` + +Pay attention to required options, defaults that might need overriding, and options relevant to the user's request. + +### Library Buildability + +**Default to non-buildable libraries** unless there's a specific reason for buildable. + +| Type | When to use | Generator flags | +| --------------------------- | ----------------------------------------------------------------- | ----------------------------------- | +| **Non-buildable** (default) | Internal monorepo libs consumed by apps | No `--bundler` flag | +| **Buildable** | Publishing to npm, cross-repo sharing, stable libs for cache hits | `--bundler=vite` or `--bundler=swc` | + +Non-buildable libs: + +- Export `.ts`/`.tsx` source directly +- Consumer's bundler compiles them +- Faster dev experience, less config + +Buildable libs: + +- Have their own build target +- Useful for stable libs that rarely change (cache hits) +- Required for npm publishing + +**If unclear, ask the user:** "Should this library be buildable (own build step, better caching) or non-buildable (source consumed directly, simpler setup)?" + +### 4. Read Generator Source Code + +**This step is critical.** The schema alone does not tell you everything. Reading the source code helps you: + +- Know exactly what files will be created/modified and where +- Understand side effects (updating configs, installing deps, etc.) +- Identify behaviors and options not obvious from the schema +- Understand how options interact with each other + +To find generator source code: + +- For plugin generators: Use `node -e "console.log(require.resolve('@nx//generators.json'));"` to find the generators.json, then locate the source from there +- If that fails, read directly from `node_modules//generators.json` +- For local generators: Typically in `tools/generators/` or a local plugin directory. Search the repo for the generator name. + +After reading the source, reconsider: Is this the right generator? If not, go back to step 2. + +> **⚠️ `--directory` flag behavior can be misleading.** +> It should specify the full path of the generated library or component, not the parent path that it will be generated in. +> +> ```bash +> # ✅ Correct - directory is the full path for the library +> nx g @nx/react:library --directory=libs/my-lib +> # generates libs/my-lib/package.json and more +> +> # ❌ Wrong - this will create files at libs and libs/src/... +> nx g @nx/react:library --name=my-lib --directory=libs +> # generates libs/package.json and more +> ``` + +### 5. Examine Existing Patterns + +Before generating, examine the target area of the codebase: + +- Look at similar existing artifacts (other libraries, applications, etc.) +- Identify naming conventions, file structures, and configuration patterns +- Note which test runners, build tools, and linters are used +- Configure the generator to match these patterns + +### 6. Dry-Run to Verify File Placement + +**Always run with `--dry-run` first** to verify files will be created in the correct location: + +```bash +npx nx g @nx/react:library --name=my-lib --dry-run --no-interactive +``` + +Review the output carefully. If files would be created in the wrong location, adjust your options based on what you learned from the generator source code. + +Note: Some generators don't support dry-run (e.g., if they install npm packages). If dry-run fails for this reason, proceed to running the generator for real. + +### 7. Run the Generator + +Execute the generator: + +```bash +nx generate --no-interactive +``` + +> **Tip:** New packages often need workspace dependencies wired up (e.g., importing shared types, being consumed by apps). The `link-workspace-packages` skill can help add these correctly. + +### 8. Modify Generated Code (If Needed) + +Generators provide a starting point. Modify the output as needed to: + +- Add or modify functionality as requested +- Adjust imports, exports, or configurations +- Integrate with existing code patterns + +**Important:** If you replace or delete generated test files (e.g., `*.spec.ts`), either write meaningful replacement tests or remove the `test` target from the project configuration. Empty test suites will cause `nx test` to fail. + +### 9. Format and Verify + +Format all generated/modified files: + +```bash +nx format --fix +``` + +This example is for built-in nx formatting with prettier. There might be other formatting tools for this workspace, use these when appropriate. + +Then verify the generated code works. Keep in mind that the changes you make with a generator or subsequent modifications might impact various projects so it's usually not enough to only run targets for the artifact you just created. + +```bash +# these targets are just an example! +nx run-many -t build,lint,test,typecheck +``` + +These targets are common examples used across many workspaces. You should do research into other targets available for this workspace and its projects. CI configuration is usually a good guide for what the critical targets are that have to pass. + +If verification fails with manageable issues (a few lint errors, minor type issues), fix them. If issues are extensive, attempt obvious fixes first, then escalate to the user with details about what was generated, what's failing, and what you've attempted. diff --git a/.agents/skills/nx-import/SKILL.md b/.agents/skills/nx-import/SKILL.md new file mode 100644 index 00000000000..b1cd381d3dd --- /dev/null +++ b/.agents/skills/nx-import/SKILL.md @@ -0,0 +1,238 @@ +--- +name: nx-import +description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. +--- + +## Quick Start + +- `nx import` brings code from a source repository or folder into the current workspace, preserving commit history. +- After nx `22.6.0`, `nx import` responds with .ndjson outputs and follow-up questions. For earlier versions, always run with `--no-interactive` and specify all flags directly. +- Run `nx import --help` for available options. +- Make sure the destination directory is empty before importing. + EXAMPLE: target has `libs/utils` and `libs/models`; source has `libs/ui` and `libs/data-access` — you cannot import `libs/` into `libs/` directly. Import each source library individually. + +Primary docs: + +- https://nx.dev/docs/guides/adopting-nx/import-project +- https://nx.dev/docs/guides/adopting-nx/preserving-git-histories + +Read the nx docs if you have the tools for it. + +## Import Strategy + +**Subdirectory-at-a-time** (`nx import apps --source=apps`): + +- **Recommended for monorepo sources** — files land at top level, no redundant config +- Caveats: multiple import commands (separate merge commits each); dest must not have conflicting directories; root configs (deps, plugins, targetDefaults) not imported +- **Directory conflicts**: Import into alternate-named dir (e.g. `imported-apps/`), then rename + +**Whole repo** (`nx import imported --source=.`): + +- **Only for non-monorepo sources** (single-project repos) +- For monorepos, creates messy nested config (`imported/nx.json`, `imported/tsconfig.base.json`, etc.) +- If you must: keep imported `tsconfig.base.json` (projects extend it), prefix workspace globs and executor paths + +### Directory Conventions + +- **Always prefer the destination's existing conventions.** Source uses `libs/`but dest uses `packages/`? Import into `packages/` (`nx import packages/foo --source=libs/foo`). +- If dest has no convention (empty workspace), ask the user. + +### Application vs Library Detection + +Before importing, identify whether the source is an **application** or a **library**: + +- **Applications**: Deployable end products. Common indicators: + - _Frontend_: `next.config.*`, `vite.config.*` with a build entry point, framework-specific app scaffolding (CRA, Angular CLI app, etc.) + - _Backend (Node.js)_: Express/Fastify/NestJS server entrypoint, no `"exports"` field in `package.json` + - _JVM_: Maven `pom.xml` with `jar` or `war` and a `main` class; Gradle `application` plugin or `mainClass` setting + - _.NET_: `.csproj`/`.fsproj` with `Exe` or `WinExe` + - _General_: Dockerfile, a runnable entrypoint, no public API surface intended for import by other projects +- **Libraries**: Reusable packages consumed by other projects. Common indicators: `"main"`/`"exports"` in `package.json`, Maven/Gradle packaging as a library jar, .NET `Library`, named exports intended for import by other packages. + +**Destination directory rules**: + +- Applications → `apps/`. Check workspace globs (e.g. `pnpm-workspace.yaml`, `workspaces` in root `package.json`) for an existing `apps/*` entry. + - If `apps/*` is **not** present, add it before importing: update the workspace glob config and commit (or stage) the change. + - Example: `nx import apps/my-app --source=packages/my-app` +- Libraries → follow the dest's existing convention (`packages/`, `libs/`, etc.). + +## Common Issues + +### pnpm Workspace Globs (Critical) + +`nx import` adds the imported directory itself (e.g. `apps`) to `pnpm-workspace.yaml`, **NOT** glob patterns for packages within it. Cross-package imports will fail with `Cannot find module`. + +**Fix**: Replace with proper globs from the source config (e.g. `apps/*`, `libs/shared/*`), then `pnpm install`. + +### Root Dependencies and Config Not Imported (Critical) + +`nx import` does **NOT** merge from the source's root: + +- `dependencies`/`devDependencies` from `package.json` +- `targetDefaults` from `nx.json` (e.g. `"@nx/esbuild:esbuild": { "dependsOn": ["^build"] }` — critical for build ordering) +- `namedInputs` from `nx.json` (e.g. `production` exclusion patterns for test files) +- Plugin configurations from `nx.json` + +**Fix**: Diff source and dest `package.json` + `nx.json`. Add missing deps, merge relevant `targetDefaults` and `namedInputs`. + +### TypeScript Project References + +After import, run `nx sync --yes`. If it reports nothing but typecheck still fails, `nx reset` first, then `nx sync --yes` again. + +### Explicit Executor Path Fixups + +Inferred targets (via Nx plugins) resolve config relative to project root — no changes needed. Explicit executor targets (e.g. `@nx/esbuild:esbuild`) have workspace-root-relative paths (`main`, `outputPath`, `tsConfig`, `assets`, `sourceRoot`) that must be prefixed with the import destination directory. + +### Plugin Detection + +- **Whole-repo import**: `nx import` detects and offers to install plugins. Accept them. +- **Subdirectory import**: Plugins NOT auto-detected. Manually add with `npx nx add @nx/PLUGIN`. Check `include`/`exclude` patterns — defaults won't match alternate directories (e.g. `apps-beta/`). +- Run `npx nx reset` after any plugin config changes. + +### Redundant Root Files (Whole-Repo Only) + +Whole-repo import brings ALL source root files into the dest subdirectory. Clean up: + +- `pnpm-lock.yaml` — stale; dest has its own lockfile +- `pnpm-workspace.yaml` — source workspace config; conflicts with dest +- `node_modules/` — stale symlinks pointing to source filesystem +- `.gitignore` — redundant with dest root `.gitignore` +- `nx.json` — source Nx config; dest has its own +- `README.md` — optional; keep or remove + +**Don't blindly delete** `tsconfig.base.json` — imported projects may extend it via relative paths. + +### Root ESLint Config Missing (Subdirectory Import) + +Subdirectory import doesn't bring the source's root `eslint.config.mjs`, but project configs reference `../../eslint.config.mjs`. + +**Fix order**: + +1. Install ESLint deps first: `pnpm add -wD eslint@^9 @nx/eslint-plugin typescript-eslint` (plus framework-specific plugins) +2. Create root `eslint.config.mjs` (copy from source or create with `@nx/eslint-plugin` base rules) +3. Then `npx nx add @nx/eslint` to register the plugin in `nx.json` + +Install `typescript-eslint` explicitly — pnpm's strict hoisting won't auto-resolve this transitive dep of `@nx/eslint-plugin`. + +### ESLint Version Pinning (Critical) + +**Pin ESLint to v9** (`eslint@^9.0.0`). ESLint 10 breaks `@nx/eslint` and many plugins with cryptic errors like `Cannot read properties of undefined (reading 'version')`. + +`@nx/eslint` may peer-depend on ESLint 8, causing the wrong version to resolve. If lint fails with `Cannot read properties of undefined (reading 'allow')`, add `pnpm.overrides`: + +```json +{ "pnpm": { "overrides": { "eslint": "^9.0.0" } } } +``` + +### Dependency Version Conflicts + +After import, compare key deps (`typescript`, `eslint`, framework-specific). If dest uses newer versions, upgrade imported packages to match (usually safe). If source is newer, may need to upgrade dest first. Use `pnpm.overrides` to enforce single-version policy if desired. + +### Module Boundaries + +Imported projects may lack `tags`. Add tags or update `@nx/enforce-module-boundaries` rules. + +### Project Name Collisions (Multi-Import) + +Same `name` in `package.json` across source and dest causes `MultipleProjectsWithSameNameError`. **Fix**: Rename conflicting names (e.g. `@org/api` → `@org/teama-api`), update all dep references and import statements, `pnpm install`. The root `package.json` of each imported repo also becomes a project — rename those too. + +### Workspace Dep Import Ordering + +`pnpm install` fails during `nx import` if a `"workspace:*"` dependency hasn't been imported yet. File operations still succeed. **Fix**: Import all projects first, then `pnpm install --no-frozen-lockfile`. + +### `.gitkeep` Blocking Subdirectory Import + +The TS preset creates `packages/.gitkeep`. Remove it and commit before importing. + +### Frontend tsconfig Base Settings (Critical) + +The TS preset defaults (`module: "nodenext"`, `moduleResolution: "nodenext"`, `lib: ["es2022"]`) are incompatible with frontend frameworks (React, Next.js, Vue, Vite). After importing frontend projects, verify the dest root `tsconfig.base.json`: + +- **`moduleResolution`**: Must be `"bundler"` (not `"nodenext"`) +- **`module`**: Must be `"esnext"` (not `"nodenext"`) +- **`lib`**: Must include `"dom"` and `"dom.iterable"` (frontend projects need these) +- **`jsx`**: `"react-jsx"` for React-only workspaces, per-project for mixed frameworks + +For **subdirectory imports**, the dest root tsconfig is authoritative — update it. For **whole-repo imports**, imported projects may extend their own nested `tsconfig.base.json`, making this less critical. + +If the dest also has backend projects needing `nodenext`, use per-project overrides instead of changing the root. + +**Gotcha**: TypeScript does NOT merge `lib` arrays — a project-level override **replaces** the base array entirely. Always include all needed entries (e.g. `es2022`, `dom`, `dom.iterable`) in any project-level `lib`. + +### `@nx/react` Typings for Libraries + +React libraries generated with `@nx/react:library` reference `@nx/react/typings/cssmodule.d.ts` and `@nx/react/typings/image.d.ts` in their tsconfig `types`. These fail with `Cannot find type definition file` unless `@nx/react` is installed in the dest workspace. + +**Fix**: `pnpm add -wD @nx/react` + +### Jest Preset Missing (Subdirectory Import) + +Nx presets create `jest.preset.js` at the workspace root, and project jest configs reference it (e.g. `../../jest.preset.js`). Subdirectory import does NOT bring this file. + +**Fix**: + +1. Run `npx nx add @nx/jest` — registers `@nx/jest/plugin` in `nx.json` and updates `namedInputs` +2. Create `jest.preset.js` at workspace root (see `references/JEST.md` for content) — `nx add` only creates this when a generator runs, not on bare `nx add` +3. Install test runner deps: `pnpm add -wD jest jest-environment-jsdom ts-jest @types/jest` +4. Install framework-specific test deps as needed (see `references/JEST.md`) + +For deeper Jest issues (tsconfig.spec.json, Babel transforms, CI atomization, Jest vs Vitest coexistence), see `references/JEST.md`. + +### Target Name Prefixing (Whole-Repo Import) + +When importing a project with existing npm scripts (`build`, `dev`, `start`, `lint`), Nx plugins auto-prefix inferred target names to avoid conflicts: e.g. `next:build`, `vite:build`, `eslint:lint`. + +**Fix**: Remove the Nx-rewritten npm scripts from the imported `package.json`, then either: + +- Accept the prefixed names (e.g. `nx run app:next:build`) +- Rename plugin target names in `nx.json` to use unprefixed names + +## Non-Nx Source Issues + +When the source is a plain pnpm/npm workspace without `nx.json`. + +### npm Script Rewriting (Critical) + +Nx rewrites `package.json` scripts during init, creating broken commands (e.g. `vitest run` → `nx test run`). **Fix**: Remove all rewritten scripts — Nx plugins infer targets from config files. + +### `noEmit` → `composite` + `emitDeclarationOnly` (Critical) + +Plain TS projects use `"noEmit": true`, incompatible with Nx project references. + +**Symptoms**: "typecheck target is disabled because one or more project references set 'noEmit: true'" or TS6310. + +**Fix** in **all** imported tsconfigs: + +1. Remove `"noEmit": true`. If inherited via extends chain, set `"noEmit": false` explicitly. +2. Add `"composite": true`, `"emitDeclarationOnly": true`, `"declarationMap": true` +3. Add `"outDir": "dist"` and `"tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"` +4. Add `"extends": "../../tsconfig.base.json"` if missing. Remove settings now inherited from base. + +### Stale node_modules and Lockfiles + +`nx import` may bring `node_modules/` (pnpm symlinks pointing to the source filesystem) and `pnpm-lock.yaml` from the source. Both are stale. + +**Fix**: `rm -rf imported/node_modules imported/pnpm-lock.yaml imported/pnpm-workspace.yaml imported/.gitignore`, then `pnpm install`. + +### ESLint Config Handling + +- **Legacy `.eslintrc.json` (ESLint 8)**: Delete all `.eslintrc.*`, remove v8 deps, create flat `eslint.config.mjs`. +- **Flat config (`eslint.config.js`)**: Self-contained configs can often be left as-is. +- **No ESLint**: Create both root and project-level configs from scratch. + +### TypeScript `paths` Aliases + +Nx uses `package.json` `"exports"` + pnpm workspace linking instead of tsconfig `"paths"`. If packages have proper `"exports"`, paths are redundant. Otherwise, update paths for the new directory structure. + +## Technology-specific Guidance + +Identify technologies in the source repo, then read and apply the matching reference file(s). + +Available references: + +- `references/ESLINT.md` — ESLint projects: duplicate `lint`/`eslint:lint` targets, legacy `.eslintrc.*` linting generated files, flat config `.cjs` self-linting, `typescript-eslint` v7/v9 peer dep conflict, mixed ESLint v8+v9 in one workspace. +- `references/GRADLE.md` +- `references/JEST.md` — Jest testing: `@nx/jest/plugin` setup, jest.preset.js, testing deps by framework, tsconfig.spec.json, Jest vs Vitest coexistence, Babel transforms, CI atomization. +- `references/NEXT.md` — Next.js projects: `@nx/next/plugin` targets, `withNx`, Next.js TS config (`noEmit`, `jsx: "preserve"`), auto-installing deps via wrong PM, non-Nx `create-next-app` imports, mixed Next.js+Vite coexistence. +- `references/TURBOREPO.md` +- `references/VITE.md` — Vite projects (React, Vue, or both): `@nx/vite/plugin` typecheck target, `resolve.alias`/`__dirname` fixes, framework deps, Vue-specific setup, mixed React+Vue coexistence. diff --git a/.agents/skills/nx-import/references/ESLINT.md b/.agents/skills/nx-import/references/ESLINT.md new file mode 100644 index 00000000000..0d4afb8d9d0 --- /dev/null +++ b/.agents/skills/nx-import/references/ESLINT.md @@ -0,0 +1,109 @@ +## ESLint + +ESLint-specific guidance for `nx import`. For generic import issues (root deps, pnpm globs, project references), see `SKILL.md`. + +--- + +### How `@nx/eslint/plugin` Works + +`@nx/eslint/plugin` scans for ESLint config files and creates a lint target for each project. It detects **both** flat config files (`eslint.config.{js,mjs,cjs,ts,mts,cts}`) and legacy config files (`.eslintrc.{json,js,cjs,mjs,yml,yaml}`). + +**Plugin options (set during `nx add @nx/eslint`):** + +```json +{ + "plugin": "@nx/eslint/plugin", + "options": { + "targetName": "eslint:lint" + } +} +``` + +**Auto-installation**: `nx import` auto-detects ESLint config files and offers to install `@nx/eslint`. Accept the offer — it registers the plugin and updates `namedInputs.production` to exclude ESLint config files. + +--- + +### Duplicate `lint` and `eslint:lint` Targets + +After import, projects will have **two** lint-related targets if the source `package.json` has a `"lint"` npm script: + +- `eslint:lint` — inferred by `@nx/eslint/plugin`; has proper caching and input/output tracking +- `lint` — created by Nx from the npm script via `nx:run-script`; no caching intelligence, just wraps `npm run lint` + +**Fix**: Remove the `"lint"` script from each project's `package.json`. Keep `"lint:fix"` if present — there is no plugin-inferred equivalent for auto-fixing. + +--- + +### Legacy `.eslintrc.*` Configs Linting Generated Files + +When `@nx/eslint/plugin` runs `eslint .` on a project with a legacy `.eslintrc.*` config that uses `parserOptions.project`, it tries to lint **all** files in the project directory including: + +- Generated `dist/**/*.d.ts` files (not in tsconfig `include`) +- The `.eslintrc.js` config file itself (not in tsconfig `include`) + +This causes `Parsing error: ESLint was configured to run on X using parserOptions.project, however that TSConfig does not include this file`. + +**Fix**: Add `ignorePatterns` to the `.eslintrc.*` config: + +```json +// .eslintrc.json +{ + "ignorePatterns": ["dist/**"] +} +``` + +```js +// .eslintrc.js — also ignore the config file itself since module.exports isn't in tsconfig +module.exports = { + ignorePatterns: ["dist/**", ".eslintrc.js"], + // ... +}; +``` + +--- + +### Flat Config `.cjs` Files Self-Linting + +When a project uses `eslint.config.cjs` (CJS flat config), `eslint .` lints the config file itself. The `require()` call on line 1 triggers `@typescript-eslint/no-require-imports`. + +**Fix**: Add the config filename to the top-level `ignores` array: + +```js +module.exports = tseslint.config( + { + ignores: ["dist/**", "node_modules/**", "eslint.config.cjs"], + }, + // ... +); +``` + +The same applies to `eslint.config.js` in a CJS project (no `"type": "module"`) if it uses `require()`. + +--- + +### `typescript-eslint` Version Conflict With ESLint 9 + +`typescript-eslint@7.x` declares `peerDependencies: { "eslint": "^8.56.0" }`, but it is commonly used alongside `"eslint": "^9.0.0"`. npm treats this as a hard peer dep conflict and refuses to install. + +**Root cause**: `@nx/eslint` init adds `eslint@~8.57.0` at the workspace root (for its own peer deps). Workspace packages that request `eslint@^9.0.0` + `typescript-eslint@^7.0.0` trigger the conflict when npm resolves their deps. + +**Fix**: Upgrade `typescript-eslint` from `^7.0.0` to `^8.0.0` directly in the affected workspace package's `package.json`. The `tseslint.config()` API and `tseslint.configs.recommended` are identical between v7 and v8 — no config changes needed. + +```json +// packages/my-package/package.json +{ + "devDependencies": { + "typescript-eslint": "^8.0.0" + } +} +``` + +**Note**: npm's root-level `"overrides"` field does not force versions for workspace packages' direct dependencies — update each package.json individually. + +--- + +### Mixed ESLint v8 and v9 in One Workspace + +Legacy v8 and flat-config v9 packages can coexist in the same workspace. Each package resolves its own `eslint` version. The root `eslint@~8.57.0` (added by `@nx/eslint` init) is used by legacy v8 packages; v9 packages get their own hoisted `eslint@9`. + +`@nx/eslint/plugin` infers `eslint:lint` targets for **both** config formats. Legacy packages run ESLint v8 with `.eslintrc.*`; flat-config packages run ESLint v9 with `eslint.config.*`. No special nx.json configuration is needed to support both simultaneously. diff --git a/.agents/skills/nx-import/references/GRADLE.md b/.agents/skills/nx-import/references/GRADLE.md new file mode 100644 index 00000000000..30dface2ea4 --- /dev/null +++ b/.agents/skills/nx-import/references/GRADLE.md @@ -0,0 +1,12 @@ +## Gradle + +- If you import an entire Gradle repository into a subfolder, files like `gradlew`, `gradlew.bat`, and `gradle/wrapper` will end up inside that imported subfolder. +- The `@nx/gradle` plugin expects those files at the workspace root to infer Gradle projects/tasks automatically. +- If the target workspace has no Gradle setup yet, consider moving those files to the root (especially when using `@nx/gradle`). +- If the target workspace already has Gradle configured, avoid duplicate wrappers: remove imported duplicates from the subfolder or merge carefully. +- Because the import lands in a subfolder, Gradle project references can break; review settings and project path references, then fix any errors. +- If `@nx/gradle` is installed, run `nx show projects` to verify that Gradle projects are being inferred. + +Helpful docs: + +- https://nx.dev/docs/technologies/java/gradle/introduction diff --git a/.agents/skills/nx-import/references/JEST.md b/.agents/skills/nx-import/references/JEST.md new file mode 100644 index 00000000000..a0f62f6fdf6 --- /dev/null +++ b/.agents/skills/nx-import/references/JEST.md @@ -0,0 +1,228 @@ +## Jest + +Jest-specific guidance for `nx import`. For the basic "Jest Preset Missing" fix (create `jest.preset.js`, install deps), see `SKILL.md`. This file covers deeper Jest integration issues. + +--- + +### How `@nx/jest` Works + +`@nx/jest/plugin` scans for `jest.config.{ts,js,cjs,mjs,cts,mts}` and creates a `test` target for each project. + +**Plugin options:** + +```json +{ + "plugin": "@nx/jest/plugin", + "options": { + "targetName": "test" + } +} +``` + +`npx nx add @nx/jest` does two things: + +1. **Registers `@nx/jest/plugin` in `nx.json`** — without this, no `test` targets are inferred +2. Updates `namedInputs.production` to exclude test files + +**Gotcha**: `nx add @nx/jest` does NOT create `jest.preset.js` — that file is only generated when you run a generator (e.g. `@nx/jest:configuration`). For imports, you must create it manually (see "Jest Preset" section below). + +**Other gotcha**: If you create `jest.preset.js` manually but skip `npx nx add @nx/jest`, the plugin won't be registered and `nx run PROJECT:test` will fail with "Cannot find target 'test'". You need both. + +--- + +### Jest Preset + +The preset provides shared Jest configuration (test patterns, ts-jest transform, resolver, jsdom environment). + +**Root `jest.preset.js`:** + +```js +const nxPreset = require("@nx/jest/preset").default; +module.exports = { ...nxPreset }; +``` + +**Project `jest.config.ts`:** + +```ts +export default { + displayName: "my-lib", + preset: "../../jest.preset.js", + // project-specific overrides +}; +``` + +The `preset` path is relative from the project root to the workspace root. Subdirectory imports preserve the original relative path (e.g. `../../jest.preset.js`), which resolves correctly if the import destination matches the source directory depth. + +--- + +### Testing Dependencies + +#### Core (always needed) + +``` +pnpm add -wD jest ts-jest @types/jest @nx/jest +``` + +#### Environment-specific + +- **DOM testing** (React, Vue, browser libs): `jest-environment-jsdom` +- **Node testing** (APIs, CLIs): no extra deps (Jest defaults to `node` env, but Nx preset defaults to `jsdom`) + +#### React testing + +``` +pnpm add -wD @testing-library/react @testing-library/jest-dom +``` + +#### React with Babel (non-ts-jest transform) + +Some React projects use Babel instead of ts-jest for JSX transformation: + +``` +pnpm add -wD babel-jest @babel/core @babel/preset-env @babel/preset-react @babel/preset-typescript +``` + +**When**: Project `jest.config` has `transform` using `babel-jest` instead of `ts-jest`. Common in older Nx workspaces and CRA migrations. + +#### Vue testing + +``` +pnpm add -wD @vue/test-utils +``` + +Vue projects typically use Vitest (not Jest) — see VITE.md. + +--- + +### `tsconfig.spec.json` + +Jest projects need a `tsconfig.spec.json` that includes test files: + +```json +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "outDir": "../../dist/out-tsc", + "module": "commonjs", + "types": ["jest", "node"] + }, + "include": [ + "jest.config.ts", + "src/**/*.test.ts", + "src/**/*.spec.ts", + "src/**/*.d.ts" + ] +} +``` + +**Common issues after import:** + +- Missing `"types": ["jest", "node"]` — causes `describe`/`it`/`expect` to be unrecognized +- Missing `"module": "commonjs"` — Jest doesn't support ESM by default (ts-jest transpiles to CJS) +- `include` array missing test patterns — TypeScript won't check test files + +--- + +### Jest vs Vitest Coexistence + +Workspaces can have both: + +- **Jest**: Next.js apps, older React libs, Node libraries +- **Vitest**: Vite-based React/Vue apps and libs + +Both `@nx/jest/plugin` and `@nx/vite/plugin` (which infers Vitest targets) coexist without conflicts — they detect different config files (`jest.config.*` vs `vite.config.*`). + +**Target naming**: Both default to `test`. If a project somehow has both config files, rename one: + +```json +{ + "plugin": "@nx/jest/plugin", + "options": { "targetName": "jest-test" } +} +``` + +--- + +### `@testing-library/jest-dom` — Jest vs Vitest + +Projects migrating from Jest to Vitest (or workspaces with both) need different imports: + +**Jest** (in `test-setup.ts`): + +```ts +import "@testing-library/jest-dom"; +``` + +**Vitest** (in `test-setup.ts`): + +```ts +import "@testing-library/jest-dom/vitest"; +``` + +If the source used Jest but the dest workspace uses Vitest for that project type, update the import path. Also add `@testing-library/jest-dom` to tsconfig `types` array. + +--- + +### Non-Nx Source: Test Script Rewriting + +Nx rewrites `package.json` scripts during init. Test scripts get broken: + +- `"test": "jest"` → `"test": "nx test"` (circular if no executor configured) +- `"test": "vitest run"` → `"test": "nx test run"` (broken — `run` becomes an argument) + +**Fix**: Remove all rewritten test scripts. `@nx/jest/plugin` and `@nx/vite/plugin` infer test targets from config files. + +--- + +### CI Atomization + +`@nx/jest/plugin` supports splitting tests per-file for CI parallelism: + +```json +{ + "plugin": "@nx/jest/plugin", + "options": { + "targetName": "test", + "ciTargetName": "test-ci" + } +} +``` + +This creates `test-ci--src/lib/foo.spec.ts` targets for each test file, enabling Nx Cloud distribution. Not relevant during import, but useful for post-import CI setup. + +--- + +### Common Post-Import Issues + +1. **"Cannot find target 'test'"**: `@nx/jest/plugin` not registered in `nx.json`. Run `npx nx add @nx/jest` or manually add the plugin entry. + +2. **"Cannot find module 'jest-preset'"**: `jest.preset.js` missing at workspace root. Create it (see SKILL.md). + +3. **"Cannot find type definition file for 'jest'"**: Missing `@types/jest` or `tsconfig.spec.json` doesn't have `"types": ["jest", "node"]`. + +4. **Tests fail with "Cannot use import statement outside a module"**: `ts-jest` not installed or not configured as transform. Check `jest.config.ts` transform section. + +5. **Snapshot path mismatches**: After import, `__snapshots__` directories may have paths baked in. Run tests once with `--updateSnapshot` to regenerate. + +--- + +## Fix Order + +### Subdirectory Import (Nx Source) + +1. `npx nx add @nx/jest` — registers plugin in `nx.json` (does NOT create `jest.preset.js`) +2. Create `jest.preset.js` manually (see "Jest Preset" section above) +3. Install deps: `pnpm add -wD jest jest-environment-jsdom ts-jest @types/jest` +4. Install framework test deps: `@testing-library/react @testing-library/jest-dom` (React), `@vue/test-utils` (Vue) +5. Verify `tsconfig.spec.json` has `"types": ["jest", "node"]` +6. `nx run-many -t test` + +### Whole-Repo Import (Non-Nx Source) + +1. Remove rewritten test scripts from `package.json` +2. `npx nx add @nx/jest` — registers plugin (does NOT create preset) +3. Create `jest.preset.js` manually +4. Install deps (same as above) +5. Verify/fix `jest.config.*` — ensure `preset` path points to root `jest.preset.js` +6. Verify/fix `tsconfig.spec.json` — add `types`, `module`, `include` if missing +7. `nx run-many -t test` diff --git a/.agents/skills/nx-import/references/NEXT.md b/.agents/skills/nx-import/references/NEXT.md new file mode 100644 index 00000000000..d9ec1f0b557 --- /dev/null +++ b/.agents/skills/nx-import/references/NEXT.md @@ -0,0 +1,214 @@ +## Next.js + +Next.js-specific guidance for `nx import`. For generic import issues (pnpm globs, root deps, project references, name collisions, ESLint, frontend tsconfig base settings, `@nx/react` typings, Jest preset, target name prefixing, non-Nx source handling), see `SKILL.md`. + +--- + +### `@nx/next/plugin` Inferred Targets + +`@nx/next/plugin` detects `next.config.{ts,js,cjs,mjs}` and creates these targets: + +- `build` → `next build` (with `dependsOn: ['^build']`) +- `dev` → `next dev` +- `start` → `next start` (depends on `build`) +- `serve-static` → same as `start` +- `build-deps` / `watch-deps` — for TS solution setup + +**No separate typecheck target** — Next.js runs TypeScript checking as part of `next build`. The `@nx/js/typescript` plugin provides a standalone `typecheck` target for non-Next libraries in the workspace. + +**Build target conflict**: Both `@nx/next/plugin` and `@nx/js/typescript` define a `build` target. `@nx/next/plugin` wins for Next.js projects (it detects `next.config.*`), while `@nx/js/typescript` handles libraries with `tsconfig.lib.json`. No rename needed — they coexist. + +### `withNx` in `next.config.js` + +Nx-generated Next.js projects use `composePlugins(withNx)` from `@nx/next`. This wrapper is optional for `next build` via the inferred plugin (which just runs `next build`), but it provides Nx-specific configuration. Keep it if present. + +### Root Dependencies for Next.js + +Beyond the generic root deps issue (see SKILL.md), Next.js projects typically need: + +**Core**: `react`, `react-dom`, `@types/react`, `@types/react-dom`, `@types/node`, `@nx/react` (see SKILL.md for `@nx/react` typings) +**Nx plugins**: `@nx/next` (auto-installed by import), `@nx/eslint`, `@nx/jest` +**Testing**: see SKILL.md "Jest Preset Missing" section +**ESLint**: `@next/eslint-plugin-next` (in addition to generic ESLint deps from SKILL.md) + +### Next.js Auto-Installing Dependencies via Wrong Package Manager + +Next.js detects missing `@types/react` during `next build` and tries to install it using `yarn add` regardless of the actual package manager. In a pnpm workspace, this fails with a "nearest package directory isn't part of the project" error. + +**Root cause**: `@types/react` is missing from root devDependencies. +**Fix**: Install deps at the root before building: `pnpm add -wD @types/react @types/react-dom` + +### Next.js TypeScript Config Specifics + +Next.js app tsconfigs have unique patterns compared to Vite: + +- **`noEmit: true`** with `emitDeclarationOnly: false` — Next.js handles emit, TS just checks types. This conflicts with `composite: true` from the TS solution setup. +- **`"types": ["jest", "node"]`** — includes test types in the main tsconfig (no separate `tsconfig.app.json`) +- **`"plugins": [{ "name": "next" }]`** — for IDE integration +- **`include`** references `.next/types/**/*.ts` for Next.js auto-generated types +- **`"jsx": "preserve"`** — Next.js uses its own JSX transform, not React's + +**Gotcha**: The Next.js tsconfig sets `"noEmit": true` which disables `composite` mode. This is fine because Next.js projects use `next build` for building, not `tsc`. The `@nx/js/typescript` plugin's `typecheck` target is not needed for Next.js apps. + +### `next.config.js` Lint Warning + +Imported Next.js configs may have `// eslint-disable-next-line @typescript-eslint/no-var-requires` but the project ESLint config enables different rule sets. This produces `Unused eslint-disable directive` warnings. Harmless — remove the comment or ignore. + +### `@nx/next:init` Rewrites All npm Scripts (Whole-Repo Import) + +When `@nx/next:init` runs during a whole-repo import, it rewrites the project's `package.json` scripts to prefixed `nx` calls: + +```json +{ + "dev": "nx next:dev", + "build": "nx next:build", + "start": "nx next:start" +} +``` + +This is the standard "npm Script Rewriting" issue from SKILL.md, but triggered by `@nx/next:init` rather than Nx init. **Fix**: Remove all rewritten scripts from `package.json` — `@nx/next/plugin` infers all targets from `next.config.*`. + +--- + +## Non-Nx Source (create-next-app) + +### Whole-Repo Import Recommended + +For single-project `create-next-app` repos, use whole-repo import into a subdirectory: + +```bash +nx import /path/to/source apps/web --ref=main --source=. --no-interactive +``` + +### `next-env.d.ts` + +`next build` auto-generates `next-env.d.ts` at the project root. Add `next-env.d.ts` to the dest root `.gitignore` — it is framework-generated and should not be committed. + +### ESLint: Self-Contained `eslint-config-next` + +`create-next-app` generates a flat ESLint config using `eslint-config-next` (which bundles its own plugins). This is **self-contained** — no root `eslint.config.mjs` needed, no `@nx/eslint-plugin` dependency. The `@nx/eslint/plugin` detects it and creates a lint target. + +### TypeScript: No Changes Needed + +Non-Nx Next.js projects have self-contained tsconfigs with `noEmit: true`, their own `lib`, `module`, `moduleResolution`, and `jsx` settings. Since `next build` handles type checking internally, no tsconfig modifications are needed. The project does NOT need to extend `tsconfig.base.json`. + +**Gotcha**: The `@nx/js/typescript` plugin won't create a `typecheck` target because there's no `tsconfig.lib.json`. This is fine — use `next:build` for type checking. + +### `noEmit: true` and TS Solution Setup + +Non-Nx Next.js projects use `noEmit: true`, which conflicts with Nx's TS solution setup (`composite: true`). If the dest workspace uses project references and you want the Next.js app to participate: + +1. Remove `noEmit: true`, add `composite: true`, `emitDeclarationOnly: true` +2. Add `extends: "../../tsconfig.base.json"` +3. Add `outDir` and `tsBuildInfoFile` + +**However**, this is optional for standalone Next.js apps that don't export types consumed by other workspace projects. + +### Tailwind / PostCSS + +`create-next-app` with Tailwind generates `postcss.config.mjs`. This works as-is after import — no path changes needed since PostCSS resolves relative to the project root. + +--- + +## Mixed Next.js + Vite Coexistence + +When both Next.js and Vite projects exist in the same workspace. + +### Plugin Coexistence + +Both `@nx/next/plugin` and `@nx/vite/plugin` can coexist in `nx.json`. They detect different config files (`next.config.*` vs `vite.config.*`) so there are no conflicts. The `@nx/js/typescript` plugin handles libraries. + +### Vite Standalone Project tsconfig Fixes + +Vite standalone projects (imported as whole-repo) have self-contained tsconfigs without `composite: true`. The `@nx/js/typescript` plugin's typecheck target runs `tsc --build --emitDeclarationOnly` which requires `composite`. + +**Fix**: + +1. Add `extends: "../../tsconfig.base.json"` to the root project tsconfig +2. Add `composite: true`, `declaration: true`, `declarationMap: true`, `tsBuildInfoFile` to `tsconfig.app.json` and `tsconfig.spec.json` +3. Set `moduleResolution: "bundler"` (replace `"node"`) +4. Add source files to `tsconfig.spec.json` `include` — specs import app code, and `composite` mode requires all files to be listed + +### Typecheck Target Names + +- `@nx/vite/plugin` defaults `typecheckTargetName` to `"vite:typecheck"` +- `@nx/js/typescript` uses `"typecheck"` +- Next.js projects have NO standalone typecheck target — Next.js runs type checking during `next build` + +No naming conflicts between frameworks. + +--- + +## Fix Order — Nx Source (Subdirectory Import) + +1. Import Next.js apps into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) +3. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` +4. ESLint setup (see SKILL.md: "Root ESLint Config Missing") +5. Jest setup (see SKILL.md: "Jest Preset Missing") +6. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` + +## Fix Order — Non-Nx Source (create-next-app) + +1. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) +3. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) +4. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) + +--- + +## Iteration Log + +### Scenario 1: Basic Nx Next.js App Router + Shared Lib → TS preset (PASS) + +- Source: CNW next preset (Next.js 16, App Router) + `@nx/react:library` shared-ui +- Dest: CNW ts preset (Nx 23) +- Import: subdirectory-at-a-time (apps, libs separately) +- Errors found & fixed: + 1. pnpm-workspace.yaml: `apps`/`libs` → `apps/*`/`libs/*` + 2. Root tsconfig: `nodenext` → `bundler`, add `dom`/`dom.iterable` to `lib`, add `jsx: react-jsx` + 3. Missing `@nx/react` (for CSS module/image type defs in lib) + 4. Missing `@types/react`, `@types/react-dom`, `@types/node` + 5. Next.js trying `yarn add @types/react` — fixed by installing at root + 6. Missing `@nx/eslint`, root `eslint.config.mjs`, ESLint plugins + 7. Missing `@nx/jest`, `jest.preset.js`, `jest-environment-jsdom`, `ts-jest` +- All targets green: typecheck, build, test, lint + +### Scenario 3: Non-Nx create-next-app (App Router + Tailwind) → TS preset (PASS) + +- Source: `create-next-app@latest` (Next.js 16.1.6, App Router, Tailwind v4, flat ESLint config) +- Dest: CNW ts preset (Nx 23) +- Import: whole-repo into `apps/web` +- Errors found & fixed: + 1. pnpm-workspace.yaml: `apps/web` → `apps/*` + 2. Stale files: `node_modules/`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, `.gitignore` — deleted + 3. Nx-rewritten npm scripts (`"build": "nx next:build"`, etc.) — removed +- No tsconfig changes needed — self-contained config with `noEmit: true` +- ESLint self-contained via `eslint-config-next` — no root config needed +- No test setup (create-next-app doesn't include tests) +- All targets green: next:build, eslint:lint + +### Scenario 4: Non-Nx create-next-app (alongside Vite, React Router 7, TanStack, CRA) → TS preset (PASS) + +- See VITE.md Scenario 6 for the full multi-import scenario +- Next.js-specific findings: + 1. `@nx/next:init` rewrote all scripts to `nx next:*` format — removed all rewritten scripts + 2. Stale files: `node_modules/`, `package-lock.json`, `.gitignore` — deleted (npm workspace, no pnpm files) + 3. ESLint self-contained via `eslint-config-next` — no root config needed + 4. No tsconfig changes needed — `noEmit: true` stays; `next build` handles type checking +- Targets: `next:build`, `next:dev`, `next:start`, `eslint:lint` + +### Scenario 5: Mixed Next.js (Nx) + Vite React (standalone) → TS preset (PASS) + +- Source A: CNW next preset (Next.js 16, App Router) — subdirectory import of `apps/` +- Source B: CNW react-standalone preset (Vite 7, React 19) — whole-repo import into `apps/vite-app` +- Dest: CNW ts preset (Nx 23) +- Errors found & fixed: + 1. All Scenario 1 fixes for the Next.js app + 2. Stale files from Vite source: `node_modules/`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, `.gitignore`, `nx.json` + 3. Removed rewritten scripts from Vite app's `package.json` + 4. ESLint 8 vs 9 conflict — `@nx/eslint` peer on ESLint 8 resolved wrong version. Fixed with `pnpm.overrides` + 5. Vite tsconfigs missing `composite: true`, `declaration: true` — needed for `tsc --build --emitDeclarationOnly` + 6. Vite `tsconfig.spec.json` `include` missing source files — specs import app code + 7. Vite tsconfig `moduleResolution: "node"` → `"bundler"`, added `extends: "../../tsconfig.base.json"` +- All targets green: typecheck, build, test, lint for both projects diff --git a/.agents/skills/nx-import/references/TURBOREPO.md b/.agents/skills/nx-import/references/TURBOREPO.md new file mode 100644 index 00000000000..b322b54466a --- /dev/null +++ b/.agents/skills/nx-import/references/TURBOREPO.md @@ -0,0 +1,62 @@ +## Turborepo + +- Nx replaces Turborepo task orchestration, but a clean migration requires handling Turborepo's config packages. +- Migration guide: https://nx.dev/docs/guides/adopting-nx/from-turborepo#easy-automated-migration-example +- Since Nx replaces Turborepo, all turbo config files and config packages become dead code and should be removed. + +## The Config-as-Package Pattern + +Turborepo monorepos ship with internal workspace packages that share configuration: + +- **`@repo/typescript-config`** (or similar) — tsconfig files (`base.json`, `nextjs.json`, `react-library.json`, etc.) +- **`@repo/eslint-config`** (or similar) — ESLint config files and all ESLint plugin dependencies + +These are not code libraries. They distribute config via Node module resolution (e.g., `"extends": "@repo/typescript-config/nextjs.json"`). This is the **default** Turborepo pattern — expect it in virtually every Turborepo import. Package names vary — check `package.json` files to identify the actual names. + +## Check for Root Config Files First + +**Before doing any config merging, check whether the destination workspace uses shared root configuration.** This decides how to handle the config packages. + +- If the workspace has a root `tsconfig.base.json` and/or root `eslint.config.mjs` that projects extend, merge the config packages into these root configs (see steps below). +- If the workspace does NOT have root config files — each project manages its own configuration independently (similar to Turborepo). In this case, **do not create root config files or merge into them**. Just remove turbo-specific parts (`turbo.json`, `eslint-plugin-turbo`) and leave the config packages in place, or ask the user how they want to handle them. + +If unclear, check for the presence of `tsconfig.base.json` at the root or ask the user. + +## Merging TypeScript Config (Only When Root tsconfig.base.json Exists) + +The config package contains a hierarchy of tsconfig files. Each project extends one via package name. + +1. **Read the config package** — trace the full inheritance chain (e.g., `nextjs.json` extends `base.json`). +2. **Update root `tsconfig.base.json`** — absorb `compilerOptions` from the base config. Add Nx `paths` for cross-project imports (Turborepo doesn't use path aliases, Nx relies on them). +3. **Update each project's `tsconfig.json`**: + - Change `"extends"` from `"@repo/typescript-config/.json"` to the relative path to root `tsconfig.base.json`. + - Inline variant-specific overrides from the intermediate config (e.g., Next.js: `"module": "ESNext"`, `"moduleResolution": "Bundler"`, `"jsx": "preserve"`, `"noEmit": true`; React library: `"jsx": "react-jsx"`). + - Preserve project-specific settings (`outDir`, `include`, `exclude`, etc.). +4. **Delete the config package** and remove it from all `devDependencies`. + +## Merging ESLint Config (Only When Root eslint.config Exists) + +The config package centralizes ESLint plugin dependencies and exports composable flat configs. + +1. **Read the config package** — identify exported configs, plugin dependencies, and inheritance. +2. **Update root `eslint.config.mjs`** — absorb base rules (JS recommended, TypeScript-ESLint, Prettier, etc.). Drop `eslint-plugin-turbo`. +3. **Update each project's `eslint.config.mjs`** — switch from importing `@repo/eslint-config/` to extending the root config, adding framework-specific plugins inline. +4. **Move ESLint plugin dependencies** from the config package to root `devDependencies`. +5. If `@nx/eslint` plugin is configured with inferred targets, remove `"lint"` scripts from project `package.json` files. +6. **Delete the config package** and remove it from all `devDependencies`. + +## General Cleanup + +- Remove turbo-specific dependencies: `turbo`, `eslint-plugin-turbo`. +- Delete all `turbo.json` files (root and per-package). +- Run workspace validation (`nx run-many -t build lint test typecheck`) to confirm nothing broke. + +## Key Pitfalls + +- **Trace the full inheritance chain** before inlining — check what each variant inherits from the base. +- **Module resolution changes** — from Node package resolution (`@repo/...`) to relative paths (`../../tsconfig.base.json`). +- **ESLint configs are JavaScript, not JSON** — handle JS imports, array spreading, and plugin objects when merging. + +Helpful docs: + +- https://nx.dev/docs/guides/adopting-nx/from-turborepo diff --git a/.agents/skills/nx-import/references/VITE.md b/.agents/skills/nx-import/references/VITE.md new file mode 100644 index 00000000000..5b3817eba42 --- /dev/null +++ b/.agents/skills/nx-import/references/VITE.md @@ -0,0 +1,397 @@ +## Vite + +Vite-specific guidance for `nx import`. For generic import issues (pnpm globs, root deps, project references, name collisions, ESLint, frontend tsconfig base settings, `@nx/react` typings, Jest preset, non-Nx source handling), see `SKILL.md`. + +--- + +### `@nx/vite/plugin` Typecheck Target + +`@nx/vite/plugin` defaults `typecheckTargetName` to `"vite:typecheck"`. If the workspace expects `"typecheck"`, set it explicitly in `nx.json`. If `@nx/js/typescript` is also registered, rename one target to avoid conflicts (e.g. `"tsc-typecheck"` for the JS plugin). + +Keep both plugins only if the workspace has non-Vite pure TS libraries — `@nx/js/typescript` handles those while `@nx/vite/plugin` handles Vite projects. + +### @nx/vite Plugin Install Failure + +Plugin init loads `vite.config.ts` before deps are available. **Fix**: `pnpm add -wD vite @vitejs/plugin-react` (or `@vitejs/plugin-vue`) first, then `pnpm exec nx add @nx/vite`. + +### Vite `resolve.alias` and `__dirname` (Non-Nx Sources) + +**`__dirname` undefined** (CJS-only): Replace with `fileURLToPath(new URL('./src', import.meta.url))` from `'node:url'`. + +**`@/` path alias**: Vite's `resolve.alias` works at runtime but TS needs matching `"paths"`. Set `"baseUrl": "."` in project tsconfig. + +**PostCSS/Tailwind**: Verify `content` globs resolve correctly after import. + +### Missing TypeScript `types` (Non-Nx Sources) + +Non-Nx tsconfigs may not declare all needed types. Ensure Vite projects include `"types": ["node", "vite/client"]` in their tsconfig. + +### `noEmit` Fix: Vite-Specific Notes + +See SKILL.md for the generic noEmit→composite fix. Vite-specific additions: + +- Non-Nx Vite projects often have **both** `tsconfig.app.json` and `tsconfig.node.json` with `noEmit` — fix both +- Solution-style tsconfigs (`"files": [], "references": [...]`) may lack `extends`. Add `extends` pointing to the dest root `tsconfig.base.json` so base settings (`moduleResolution`, `lib`) apply. +- This is safe — Vite/Vitest ignore TypeScript emit settings. + +### Dependency Version Conflicts + +**Shared Vite deps (both frameworks):** `vite`, `vitest`, `jsdom`, `@types/node`, `typescript` (dev) + +**Vite 6→7**: Typecheck fails (`Plugin` type mismatch); build/serve still works. Fix: align versions. +**Vitest 3→4**: Usually works; type conflicts may surface in shared test utils. + +--- + +## React Router 7 (Vite-Based) + +React Router 7 (`@react-router/dev`) uses Vite under the hood with a `vite.config.ts` and a `react-router.config.ts`. The `@nx/vite/plugin` detects `vite.config.ts` and creates inferred targets. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `serve` targets. The `build` target invokes the script defined in `package.json` (usually `react-router build`), not `vite build` directly. + +**No separate typecheck target from `@nx/vite/plugin`** — React Router 7 typegen is run as part of `typecheck` (e.g. `react-router typegen && tsc`). The `typecheck` target is inferred from the tsconfig. Keep the `typecheck` script in `package.json` if present; it is not rewritten. + +### tsconfig Notes + +React Router 7 uses a single `tsconfig.json` (no `tsconfig.app.json`/`tsconfig.node.json` split). It includes: + +- `"rootDirs": [".", "./.react-router/types"]` — for generated type files; keep as-is +- `"paths": { "~/*": ["./app/*"] }` — self-referential alias; keep as-is +- `"noEmit": true` — replace with composite settings per SKILL.md + +### Build Output + +React Router 7 outputs to `build/` (not `dist/`). Add `build` to the dest root `.gitignore`. + +### Generated Types Directory + +React Router 7 generates `.react-router/` at the project root for route type generation. Add `.react-router` to the dest root `.gitignore`. + +--- + +## TanStack Start (Vite-Based) + +TanStack Start uses Vinxi under the hood, which wraps Vite. Projects have a standard `vite.config.ts` that `@nx/vite/plugin` detects normally. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `preview`, `serve-static`, `typecheck` targets. The `build` target runs `vite build` which invokes the TanStack Start Vinxi pipeline (produces both client and SSR bundles). + +### tsconfig Notes + +TanStack Start uses a single `tsconfig.json` with `"allowImportingTsExtensions": true` and `"noEmit": true`. Apply the standard noEmit → composite fix. `allowImportingTsExtensions` is compatible with `emitDeclarationOnly: true` — no change needed. + +### `paths` Aliases + +TanStack Start commonly uses `"#/*": ["./src/*"]` and `"@/*": ["./src/*"]`. These are self-referential — keep as-is for a single-project app. + +### Uncommitted Source Repo + +`create-tan-stack` initializes a git repo but does NOT make an initial commit. Before importing, commit first: + +```bash +git -C /path/to/source add . && git -C /path/to/source commit -m "Initial commit" +``` + +### Generated and Build Directories + +TanStack Start / Vinxi / Nitro generate several directories that must be added to the dest root `.gitignore`: + +- `.vinxi` — Vinxi build cache +- `.tanstack` — TanStack generated files +- `.nitro` — Nitro build artifacts +- `.output` — server-side build output (SSR/edge) + +These are not covered by `dist` or `build`. + +--- + +## React-Specific + +### React Dependencies + +**Production:** `react`, `react-dom` +**Dev:** `@types/react`, `@types/react-dom`, `@vitejs/plugin-react`, `@testing-library/react`, `@testing-library/jest-dom`, `jsdom` +**ESLint (Nx sources):** `eslint-plugin-import`, `eslint-plugin-jsx-a11y`, `eslint-plugin-react`, `eslint-plugin-react-hooks` +**ESLint (`create-vite`):** `eslint-plugin-react-refresh`, `eslint-plugin-react-hooks` — self-contained flat configs can be left as-is +**Nx plugins:** `@nx/react` (generators), `@nx/vite`, `@nx/vitest`, `@nx/eslint` + +### React TypeScript Configuration + +Add `"jsx": "react-jsx"` — in `tsconfig.base.json` for single-framework workspaces, per-project for mixed (see Mixed section). + +### React ESLint Config + +```js +import nx from "@nx/eslint-plugin"; +import baseConfig from "../../eslint.config.mjs"; +export default [ + ...baseConfig, + ...nx.configs["flat/react"], + { files: ["**/*.ts", "**/*.tsx"], rules: {} }, +]; +``` + +### React Version Conflicts + +React 18 (source) + React 19 (dest): pnpm may hoist mismatched `react-dom`, causing `TypeError: Cannot read properties of undefined (reading 'S')`. **Fix**: Align versions with `pnpm.overrides`. + +### `@testing-library/jest-dom` with Vitest + +If source used Jest: change import to `@testing-library/jest-dom/vitest` in test-setup.ts, add to tsconfig `types`. + +--- + +## Vue-Specific + +### Vue Dependencies + +**Production:** `vue` (plus `vue-router`, `pinia` if used) +**Dev:** `@vitejs/plugin-vue`, `vue-tsc`, `@vue/test-utils`, `jsdom` +**ESLint:** `eslint-plugin-vue`, `vue-eslint-parser`, `@vue/eslint-config-typescript`, `@vue/eslint-config-prettier` +**Nx plugins:** `@nx/vue` (generators), `@nx/vite`, `@nx/vitest`, `@nx/eslint` (install AFTER deps — see below) + +### Vue TypeScript Configuration + +Add to `tsconfig.base.json` (single-framework) or per-project (mixed): + +```json +{ "jsx": "preserve", "jsxImportSource": "vue", "resolveJsonModule": true } +``` + +### `vue-shims.d.ts` + +Vue SFC files need a type declaration. Usually exists in each project's `src/` and imports cleanly. If missing: + +```ts +declare module "*.vue" { + import { defineComponent } from "vue"; + const component: ReturnType; + export default component; +} +``` + +### `vue-tsc` Auto-Detection + +Both `@nx/js/typescript` and `@nx/vite/plugin` auto-detect `vue-tsc` when installed — no manual config needed. Remove source scripts like `"typecheck": "vue-tsc --noEmit"`. + +### ESLint Plugin Installation Order (Critical) + +`@nx/eslint` init **crashes** if Vue ESLint deps aren't installed first (it loads all config files). + +**Correct order:** + +1. `pnpm add -wD eslint@^9 eslint-plugin-vue vue-eslint-parser @vue/eslint-config-typescript @typescript-eslint/parser @nx/eslint-plugin typescript-eslint` +2. Create root `eslint.config.mjs` +3. Then `npx nx add @nx/eslint` + +### Vue ESLint Config Pattern + +```js +import vue from "eslint-plugin-vue"; +import vueParser from "vue-eslint-parser"; +import tsParser from "@typescript-eslint/parser"; +import baseConfig from "../../eslint.config.mjs"; +export default [ + ...baseConfig, + ...vue.configs["flat/recommended"], + { + files: ["**/*.vue"], + languageOptions: { parser: vueParser, parserOptions: { parser: tsParser } }, + }, + { + files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.vue"], + rules: { "vue/multi-word-component-names": "off" }, + }, +]; +``` + +**Important**: `vue-eslint-parser` override must come **AFTER** base config — `flat/typescript` sets the TS parser globally without a `files` filter, breaking `.vue` parsing. + +`vue-eslint-parser` must be an explicit pnpm dependency (strict resolution prevents transitive import). + +**Known issue**: Some generated Vue ESLint configs omit `vue-eslint-parser`. Use the pattern above instead. + +--- + +## Mixed React + Vue + +When both frameworks coexist, several settings become per-project. + +### tsconfig `jsx` — Per-Project Only + +- React: `"jsx": "react-jsx"` in project tsconfig +- Vue: `"jsx": "preserve"`, `"jsxImportSource": "vue"` in project tsconfig +- Root: **NO** `jsx` setting + +### Typecheck — Auto-Detects Framework + +`@nx/vite/plugin` uses `vue-tsc` for Vue projects and `tsc` for React automatically. + +```json +{ + "plugins": [ + { "plugin": "@nx/eslint/plugin", "options": { "targetName": "lint" } }, + { + "plugin": "@nx/vite/plugin", + "options": { + "buildTargetName": "build", + "typecheckTargetName": "typecheck", + "testTargetName": "test" + } + } + ] +} +``` + +Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-typecheck"`) only for non-Vite pure TS libs. + +### ESLint — Three-Tier Config + +1. **Root**: Base rules only, no framework-specific rules +2. **React projects**: Extend root + `nx.configs['flat/react']` +3. **Vue projects**: Extend root + `vue.configs['flat/recommended']` + `vue-eslint-parser` + +**Required packages**: Shared (`eslint@^9`, `@nx/eslint-plugin`, `typescript-eslint`, `@typescript-eslint/parser`), React (`eslint-plugin-import`, `eslint-plugin-jsx-a11y`, `eslint-plugin-react`, `eslint-plugin-react-hooks`), Vue (`eslint-plugin-vue`, `vue-eslint-parser`) + +`@nx/react`/`@nx/vue` are for generators only — no target conflicts. + +--- + +## Redundant npm Scripts After Import + +`nx import` copies `package.json` verbatim, so npm scripts come along. For Vite-based projects `@nx/vite/plugin` already infers the same targets from `vite.config.ts` — the npm scripts just shadow the plugin with weaker `nx:run-script` wrappers (no first-class caching inputs/outputs). Remove them after import. + +### Standalone Vite App (`create-vite`) + +Remove the following scripts — every one is redundant: + +| Script | Plugin replacement | +| ----------------------------- | ---------------------------------------------------------------------------- | +| `dev: vite` | `@nx/vite/plugin` → `dev` | +| `build: tsc -b && vite build` | `@nx/vite/plugin` → `build`; `typecheck` via `@nx/js/typescript` handles tsc | +| `preview: vite preview` | `@nx/vite/plugin` → `preview` | +| `lint: eslint .` | `@nx/eslint/plugin` → `eslint:lint` | + +### TanStack Start + +Remove `build`, `dev`, `preview`, and `test` scripts, but move any hardcoded `--port` flag to `vite.config.ts` first: + +```ts +// vite.config.ts +export default defineConfig({ + server: { port: 3000 }, // replaces `vite dev --port 3000` + ... +}) +``` + +### React Router 7 — Keep ALL scripts + +Do **not** remove React Router 7 scripts. They use the framework CLI (`react-router build`, `react-router dev`, `react-router-serve`) which is not interchangeable with plain `vite`: + +- `typecheck` runs `react-router typegen && tsc` — typegen must precede `tsc` or it fails on missing route types +- `start` serves the SSR bundle — no plugin equivalent + +--- + +## Fix Orders + +### Nx Source + +1. Generic fixes from SKILL.md (pnpm globs, root deps, executor paths, frontend tsconfig base settings, `@nx/react` typings) +2. Configure `@nx/vite/plugin` typecheck target +3. **React**: `jsx: "react-jsx"` (root or per-project) +4. **Vue**: `jsx: "preserve"` + `jsxImportSource: "vue"`; verify `vue-shims.d.ts`; install ESLint deps before `@nx/eslint` +5. **Mixed**: `jsx` per-project; remove/rename `@nx/js/typescript` +6. `nx sync --yes && nx reset && nx run-many -t typecheck,build,test,lint` + +### Non-Nx Source (additional steps) + +0. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +1. Generic fixes from SKILL.md (stale files cleanup, pnpm globs, rewritten scripts, target name prefixing, noEmit→composite, ESLint handling) +2. Fix `noEmit` in **all** tsconfigs (app, node, etc. — non-Nx projects often have multiple) +3. Add `extends` to solution-style tsconfigs so root settings apply +4. Fix `resolve.alias` / `__dirname` / `baseUrl` +5. Ensure `types` include `vite/client` and `node` +6. Install `@nx/vite` manually if it failed during import +7. Remove redundant npm scripts so `@nx/vite/plugin` infers them natively (see "Redundant npm Scripts" section) +8. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores +9. Full verification + +### Multiple-Source Imports + +See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific: fix tsconfig `references` paths for alternate directories (`../../libs/` → `../../libs-beta/`). + +### Non-Nx Source: React Router 7 + +1. Ensure source has at least one commit (see SKILL.md: "Source Repo Has No Commits") +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/react` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Add `build` and `.react-router` to dest root `.gitignore` +6. **Keep all npm scripts** — React Router 7 uses framework CLI (`react-router build/dev`), not plain vite (see "Redundant npm Scripts" above) +7. `npm install && nx reset && nx sync --yes` + +### Non-Nx Source: TanStack Start + +1. Ensure source has at least one commit — `create-tan-stack` does NOT auto-commit (see SKILL.md) +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/vitest` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Keep `allowImportingTsExtensions` — compatible with `emitDeclarationOnly: true` +6. Add `.vinxi`, `.tanstack`, `.nitro`, `.output` to dest root `.gitignore` +7. Move hardcoded `--port` from `dev` script into `vite.config.ts` (`server: { port: N }`) +8. Remove redundant npm scripts — `@nx/vite/plugin` infers `build`, `dev`, `preview`, `test` (see "Redundant npm Scripts" above) +9. `npm install && nx reset && nx sync --yes` + +### Quick Reference: React vs Vue + +| Aspect | React | Vue | +| ------------- | ------------------------ | ----------------------------------------- | +| Vite plugin | `@vitejs/plugin-react` | `@vitejs/plugin-vue` | +| Type checker | `tsc` | `vue-tsc` (auto-detected) | +| SFC support | N/A | `vue-shims.d.ts` needed | +| tsconfig jsx | `"react-jsx"` | `"preserve"` + `"jsxImportSource": "vue"` | +| ESLint parser | Standard TS | `vue-eslint-parser` + TS sub-parser | +| ESLint setup | Straightforward | Must install deps before `@nx/eslint` | +| Test utils | `@testing-library/react` | `@vue/test-utils` | + +### Quick Reference: Vite-Based React Frameworks + +| Aspect | Vite (standalone) | React Router 7 | TanStack Start | +| ------------------ | ----------------- | ----------------------- | ------------------------ | +| Build config | `vite.config.ts` | `vite.config.ts` | `vite.config.ts` | +| Build output | `dist/` | `build/` | `dist/` | +| SSR bundle | No | Yes (`build/server/`) | Yes (`dist/server/`) | +| tsconfig layout | app + node split | Single tsconfig | Single tsconfig | +| Auto-committed | Depends on tool | Usually yes | **No — commit first** | +| `nx import` plugin | `@nx/vite` | `@nx/vite`, `@nx/react` | `@nx/vite`, `@nx/vitest` | + +--- + +## Iteration Log + +### Scenario 6: Multiple non-Nx React apps (CRA, Next.js, React Router 7, TanStack Start, Vite) → TS preset (PASS) + +- Sources: 5 standalone non-Nx repos with different build tools +- Dest: CNW ts preset (Nx 22.5.1), npm workspaces, `packages/*` +- Import: whole-repo for each, sequential into `packages/` +- Pre-import fixes: + 1. Removed `packages/.gitkeep` and committed + 2. `git init && git add . && git commit` in Vite app (no git at all) + 3. `git add . && git commit` in TanStack app (git init'd but no commits) +- Import: `npm exec nx -- import packages/ --source=. --ref=main --no-interactive` + - Next.js import auto-installed `@nx/eslint`, `@nx/next` + - React Router 7 import auto-installed `@nx/vite`, `@nx/react`, `@nx/docker` (Dockerfile present) + - TanStack import auto-installed `@nx/vitest` +- Post-import fixes: + 1. Removed stale `node_modules/`, `package-lock.json`, `.gitignore` from each package + 2. Removed Nx-rewritten scripts from `board-games-nextjs/package.json` (had `"build": "nx next:build"`, etc.) + 3. Updated root `tsconfig.base.json`: `nodenext` → `bundler`, added `dom`/`dom.iterable` to lib, added `jsx: react-jsx` + 4. Added `build` to dest root `.gitignore` (CRA and React Router 7 output there) + 5. Fixed `noEmit` → `composite + emitDeclarationOnly` in: `board-games-vite/tsconfig.app.json`, `board-games-vite/tsconfig.node.json`, `board-games-react-router/tsconfig.json`, `board-games-tanstack/tsconfig.json` + 6. Fixed `tsBuildInfoFile` paths from `./node_modules/.tmp/...` to `./dist/...` + 7. Installed root `@types/react`, `@types/react-dom`, `@types/node` +- All targets green: `build` for all 5 projects; `typecheck` for Vite/React Router/TanStack; `next:build` for Next.js diff --git a/.agents/skills/nx-plugins/SKILL.md b/.agents/skills/nx-plugins/SKILL.md new file mode 100644 index 00000000000..89223c7f2ab --- /dev/null +++ b/.agents/skills/nx-plugins/SKILL.md @@ -0,0 +1,9 @@ +--- +name: nx-plugins +description: Find and add Nx plugins. USE WHEN user wants to discover available plugins, install a new plugin, or add support for a specific framework or technology to the workspace. +--- + +## Finding and Installing new plugins + +- List plugins: `pnpm nx list` +- Install plugins `pnpm nx add `. Example: `pnpm nx add @nx/react`. diff --git a/.agents/skills/nx-run-tasks/SKILL.md b/.agents/skills/nx-run-tasks/SKILL.md new file mode 100644 index 00000000000..7f1263a5725 --- /dev/null +++ b/.agents/skills/nx-run-tasks/SKILL.md @@ -0,0 +1,58 @@ +--- +name: nx-run-tasks +description: Helps with running tasks in an Nx workspace. USE WHEN the user wants to execute build, test, lint, serve, or run any other tasks defined in the workspace. +--- + +You can run tasks with Nx in the following way. + +Keep in mind that you might have to prefix things with npx/pnpx/yarn if the user doesn't have nx installed globally. Look at the package.json or lockfile to determine which package manager is in use. + +For more details on any command, run it with `--help` (e.g. `nx run-many --help`, `nx affected --help`). + +## Understand which tasks can be run + +You can check those via `nx show project --json`, for example `nx show project myapp --json`. It contains a `targets` section which has information about targets that can be run. You can also just look at the `package.json` scripts or `project.json` targets, but you might miss out on inferred tasks by Nx plugins. + +## Run a single task + +``` +nx run : +``` + +where `project` is the project name defined in `package.json` or `project.json` (if present). + +## Run multiple tasks + +``` +nx run-many -t build test lint typecheck +``` + +You can pass a `-p` flag to filter to specific projects, otherwise it runs on all projects. You can also use `--exclude` to exclude projects, and `--parallel` to control the number of parallel processes (default is 3). + +Examples: + +- `nx run-many -t test -p proj1 proj2` — test specific projects +- `nx run-many -t test --projects=*-app --exclude=excluded-app` — test projects matching a pattern +- `nx run-many -t test --projects=tag:api-*` — test projects by tag + +## Run tasks for affected projects + +Use `nx affected` to only run tasks on projects that have been changed and projects that depend on changed projects. This is especially useful in CI and for large workspaces. + +``` +nx affected -t build test lint +``` + +By default it compares against the base branch. You can customize this: + +- `nx affected -t test --base=main --head=HEAD` — compare against a specific base and head +- `nx affected -t test --files=libs/mylib/src/index.ts` — specify changed files directly + +## Useful flags + +These flags work with `run`, `run-many`, and `affected`: + +- `--skipNxCache` — rerun tasks even when results are cached +- `--verbose` — print additional information such as stack traces +- `--nxBail` — stop execution after the first failed task +- `--configuration=` — use a specific configuration (e.g. `production`) diff --git a/.agents/skills/nx-workspace/SKILL.md b/.agents/skills/nx-workspace/SKILL.md new file mode 100644 index 00000000000..2b01d45353e --- /dev/null +++ b/.agents/skills/nx-workspace/SKILL.md @@ -0,0 +1,285 @@ +--- +name: nx-workspace +description: "Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'." +--- + +# Nx Workspace Exploration + +This skill provides read-only exploration of Nx workspaces. Use it to understand workspace structure, project configuration, available targets, and dependencies. + +Keep in mind that you might have to prefix commands with `npx`/`pnpx`/`yarn` if nx isn't installed globally. Check the lockfile to determine the package manager in use. + +## Listing Projects + +Use `nx show projects` to list projects in the workspace. + +The project filtering syntax (`-p`/`--projects`) works across many Nx commands including `nx run-many`, `nx release`, `nx show projects`, and more. Filters support explicit names, glob patterns, tag references (e.g. `tag:name`), directories, and negation (e.g. `!project-name`). + +```bash +# List all projects +nx show projects + +# Filter by pattern (glob) +nx show projects --projects "apps/*" +nx show projects --projects "shared-*" + +# Filter by tag +nx show projects --projects "tag:publishable" +nx show projects -p 'tag:publishable,!tag:internal' + +# Filter by target (projects that have a specific target) +nx show projects --withTarget build + +# Combine filters +nx show projects --type lib --withTarget test +nx show projects --affected --exclude="*-e2e" +nx show projects -p "tag:scope:client,packages/*" + +# Negate patterns +nx show projects -p '!tag:private' +nx show projects -p '!*-e2e' + +# Output as JSON +nx show projects --json +``` + +## Project Configuration + +Use `nx show project --json` to get the full resolved configuration for a project. + +**Important**: Do NOT read `project.json` directly - it only contains partial configuration. The `nx show project --json` command returns the full resolved config including inferred targets from plugins. + +You can read the full project schema at `node_modules/nx/schemas/project-schema.json` to understand nx project configuration options. + +```bash +# Get full project configuration +nx show project my-app --json + +# Extract specific parts from the JSON +nx show project my-app --json | jq '.targets' +nx show project my-app --json | jq '.targets.build' +nx show project my-app --json | jq '.targets | keys' + +# Check project metadata +nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' +``` + +## Target Information + +Targets define what tasks can be run on a project. + +```bash +# List all targets for a project +nx show project my-app --json | jq '.targets | keys' + +# Get full target configuration +nx show project my-app --json | jq '.targets.build' + +# Check target executor/command +nx show project my-app --json | jq '.targets.build.executor' +nx show project my-app --json | jq '.targets.build.command' + +# View target options +nx show project my-app --json | jq '.targets.build.options' + +# Check target inputs/outputs (for caching) +nx show project my-app --json | jq '.targets.build.inputs' +nx show project my-app --json | jq '.targets.build.outputs' + +# Find projects with a specific target +nx show projects --withTarget serve +nx show projects --withTarget e2e +``` + +## Workspace Configuration + +Read `nx.json` directly for workspace-level configuration. +You can read the full project schema at `node_modules/nx/schemas/nx-schema.json` to understand nx project configuration options. + +```bash +# Read the full nx.json +cat nx.json + +# Or use jq for specific sections +cat nx.json | jq '.targetDefaults' +cat nx.json | jq '.namedInputs' +cat nx.json | jq '.plugins' +cat nx.json | jq '.generators' +``` + +Key nx.json sections: + +- `targetDefaults` - Default configuration applied to all targets of a given name +- `namedInputs` - Reusable input definitions for caching +- `plugins` - Nx plugins and their configuration +- ...and much more, read the schema or nx.json for details + +## Affected Projects + +If the user is asking about affected projects, read the [affected projects reference](references/AFFECTED.md) for detailed commands and examples. + +## Common Exploration Patterns + +### "What's in this workspace?" + +```bash +nx show projects +nx show projects --type app +nx show projects --type lib +``` + +### "How do I build/test/lint project X?" + +```bash +nx show project X --json | jq '.targets | keys' +nx show project X --json | jq '.targets.build' +``` + +### "What depends on library Y?" + +```bash +# Use the project graph to find dependents +nx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "Y") | .key' +``` + +## Programmatic Answers + +When processing nx CLI results, use command-line tools to compute the answer programmatically rather than counting or parsing output manually. Always use `--json` flags to get structured output that can be processed with `jq`, `grep`, or other tools you have installed locally. + +### Listing Projects + +```bash +nx show projects --json +``` + +Example output: + +```json +["my-app", "my-app-e2e", "shared-ui", "shared-utils", "api"] +``` + +Common operations: + +```bash +# Count projects +nx show projects --json | jq 'length' + +# Filter by pattern +nx show projects --json | jq '.[] | select(startswith("shared-"))' + +# Get affected projects as array +nx show projects --affected --json | jq '.' +``` + +### Project Details + +```bash +nx show project my-app --json +``` + +Example output: + +```json +{ + "root": "apps/my-app", + "name": "my-app", + "sourceRoot": "apps/my-app/src", + "projectType": "application", + "tags": ["type:app", "scope:client"], + "targets": { + "build": { + "executor": "@nx/vite:build", + "options": { "outputPath": "dist/apps/my-app" } + }, + "serve": { + "executor": "@nx/vite:dev-server", + "options": { "buildTarget": "my-app:build" } + }, + "test": { + "executor": "@nx/vite:test", + "options": {} + } + }, + "implicitDependencies": [] +} +``` + +Common operations: + +```bash +# Get target names +nx show project my-app --json | jq '.targets | keys' + +# Get specific target config +nx show project my-app --json | jq '.targets.build' + +# Get tags +nx show project my-app --json | jq '.tags' + +# Get project root +nx show project my-app --json | jq -r '.root' +``` + +### Project Graph + +```bash +nx graph --print +``` + +Example output: + +```json +{ + "graph": { + "nodes": { + "my-app": { + "name": "my-app", + "type": "app", + "data": { "root": "apps/my-app", "tags": ["type:app"] } + }, + "shared-ui": { + "name": "shared-ui", + "type": "lib", + "data": { "root": "libs/shared-ui", "tags": ["type:ui"] } + } + }, + "dependencies": { + "my-app": [ + { "source": "my-app", "target": "shared-ui", "type": "static" }], + "shared-ui": [] + } + } +} +``` + +Common operations: + +```bash +# Get all project names from graph +nx graph --print | jq '.graph.nodes | keys' + +# Find dependencies of a project +nx graph --print | jq '.graph.dependencies["my-app"]' + +# Find projects that depend on a library +nx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "shared-ui") | .key' +``` + +## Troubleshooting + +### "Cannot find configuration for task X:target" + +```bash +# Check what targets exist on the project +nx show project X --json | jq '.targets | keys' + +# Check if any projects have that target +nx show projects --withTarget target +``` + +### "The workspace is out of sync" + +```bash +nx sync +nx reset # if sync doesn't fix stale cache +``` diff --git a/.agents/skills/nx-workspace/references/AFFECTED.md b/.agents/skills/nx-workspace/references/AFFECTED.md new file mode 100644 index 00000000000..e30f18f6a44 --- /dev/null +++ b/.agents/skills/nx-workspace/references/AFFECTED.md @@ -0,0 +1,27 @@ +## Affected Projects + +Find projects affected by changes in the current branch. + +```bash +# Affected since base branch (auto-detected) +nx show projects --affected + +# Affected with explicit base +nx show projects --affected --base=main +nx show projects --affected --base=origin/main + +# Affected between two commits +nx show projects --affected --base=abc123 --head=def456 + +# Affected apps only +nx show projects --affected --type app + +# Affected excluding e2e projects +nx show projects --affected --exclude="*-e2e" + +# Affected by uncommitted changes +nx show projects --affected --uncommitted + +# Affected by untracked files +nx show projects --affected --untracked +``` diff --git a/.codex/agents/ci-monitor-subagent.toml b/.codex/agents/ci-monitor-subagent.toml index 2c030fc9d47..591c7cb189e 100644 --- a/.codex/agents/ci-monitor-subagent.toml +++ b/.codex/agents/ci-monitor-subagent.toml @@ -10,7 +10,7 @@ The main agent tells you which command to run: ### FETCH_STATUS Call `ci_information` with the provided branch and select fields. Return a JSON object with ONLY these fields: -`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, userAction, cipeUrl, commitSha, shortLink }` +`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, autoApplySkipped, autoApplySkipReason, userAction, cipeUrl, commitSha, shortLink }` ### FETCH_HEAVY diff --git a/.codex/config.toml b/.codex/config.toml index 2b8a6c48614..8a814f76b36 100644 --- a/.codex/config.toml +++ b/.codex/config.toml @@ -1,10 +1,14 @@ -[mcp_servers.nx-mcp] -command = "npx" -args = [ "nx-mcp@latest", "--minimal" ] + +mcp_servers.nx-mcp.command = 'npx' +mcp_servers.nx-mcp.args = [ + 'nx', + 'mcp', + '--minimal', +] [features] multi_agent = true [agents.ci-monitor-subagent] -description = "CI helper for /monitor-ci. Fetches CI status, retrieves fix details, or updates self-healing fixes. Executes one MCP tool call and returns the result." -config_file = "agents/ci-monitor-subagent.toml" +description = 'CI helper for /monitor-ci. Fetches CI status, retrieves fix details, or updates self-healing fixes. Executes one MCP tool call and returns the result.' +config_file = 'agents/ci-monitor-subagent.toml' diff --git a/.cursor/agents/ci-monitor-subagent.md b/.cursor/agents/ci-monitor-subagent.md index e11faf87e84..96251b50cd9 100644 --- a/.cursor/agents/ci-monitor-subagent.md +++ b/.cursor/agents/ci-monitor-subagent.md @@ -15,7 +15,7 @@ The main agent tells you which command to run: ### FETCH_STATUS Call `ci_information` with the provided branch and select fields. Return a JSON object with ONLY these fields: -`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, userAction, cipeUrl, commitSha, shortLink }` +`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, autoApplySkipped, autoApplySkipReason, userAction, cipeUrl, commitSha, shortLink }` ### FETCH_HEAVY diff --git a/.cursor/commands/monitor-ci.md b/.cursor/commands/monitor-ci.md index 7b88a15d5cf..00d22643b24 100644 --- a/.cursor/commands/monitor-ci.md +++ b/.cursor/commands/monitor-ci.md @@ -27,7 +27,7 @@ You are the orchestrator for monitoring Nx Cloud CI pipeline executions and hand ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -54,9 +54,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -68,53 +68,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -122,128 +96,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -278,16 +161,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -341,16 +215,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.cursor/skills/monitor-ci/SKILL.md b/.cursor/skills/monitor-ci/SKILL.md index fe56ccedd35..a4af6cbb556 100644 --- a/.cursor/skills/monitor-ci/SKILL.md +++ b/.cursor/skills/monitor-ci/SKILL.md @@ -1,6 +1,6 @@ --- name: monitor-ci -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. --- # Monitor CI Command @@ -36,7 +36,7 @@ Parse any overrides from `$ARGUMENTS` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.cursor/skills/monitor-ci/references/fix-flows.md b/.cursor/skills/monitor-ci/references/fix-flows.md new file mode 100644 index 00000000000..b33aa02167b --- /dev/null +++ b/.cursor/skills/monitor-ci/references/fix-flows.md @@ -0,0 +1,108 @@ +# Detailed Status Handling & Fix Flows + +## Status Handling by Code + +### fix_auto_apply_skipped + +The script returns `autoApplySkipReason` in its output. + +1. Report the skip reason to the user (e.g., "Auto-apply was skipped because the previous CI pipeline execution was triggered by Nx Cloud") +2. Offer to apply the fix manually — spawn UPDATE_FIX subagent with `APPLY` if user agrees +3. Record `last_cipe_url`, enter wait mode + +### fix_apply_ready + +- Spawn UPDATE_FIX subagent with `APPLY` +- Record `last_cipe_url`, enter wait mode + +### fix_needs_local_verify + +The script returns `verifiableTaskIds` in its output. + +1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` +2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task +3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode +4. **If any fail** → Apply Locally + Enhance Flow (see below) + +### fix_needs_review + +Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): + +- If fix looks correct → apply via MCP +- If fix needs enhancement → Apply Locally + Enhance Flow +- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow + +### fix_failed / no_fix + +Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. + +### environment_issue + +1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` +3. Enter wait mode with `last_cipe_url` set + +### self_healing_throttled + +Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. + +1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) +2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` +3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. +4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode + +### no_new_cipe + +1. Report to user: no CI attempt found, suggest checking CI provider +2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode +3. Otherwise: exit with guidance + +### cipe_no_tasks + +1. Report to user: CI failed with no tasks recorded +2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode +3. If retry also returns `cipe_no_tasks`: exit with failure + +## Fix Action Flows + +### Apply via MCP + +Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. + +### Apply Locally + Enhance Flow + +1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) +2. Enhance code to fix failing tasks +3. Run failing tasks to verify +4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. +5. If passing → commit and push, enter wait mode + +### Reject + Fix From Scratch Flow + +1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `REJECT` +3. Fix from scratch locally +4. Commit and push, enter wait mode + +## Environment vs Code Failure Recognition + +When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. + +**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. + +When detected → bail immediately without running gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. + +**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. + +## Git Safety + +- Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets + +## Commit Message Format + +```bash +git commit -m "fix(): + +Failed tasks: , +Local verification: passed|enhanced|failed-pushing-to-ci" +``` diff --git a/.cursor/skills/monitor-ci/scripts/ci-poll-decide.mjs b/.cursor/skills/monitor-ci/scripts/ci-poll-decide.mjs index d14b54df090..5a296493320 100644 --- a/.cursor/skills/monitor-ci/scripts/ci-poll-decide.mjs +++ b/.cursor/skills/monitor-ci/scripts/ci-poll-decide.mjs @@ -76,6 +76,8 @@ const { failedTaskIds = [], verifiedTaskIds = [], couldAutoApplyTasks, + autoApplySkipped, + autoApplySkipReason, userAction, cipeUrl, commitSha, @@ -154,14 +156,15 @@ function isNewCipe() { // 13. self-healing in progress → poll (sh_running) // 14. flaky task auto-rerun → poll (flaky_rerun) // 15. fix auto-applied → poll (fix_auto_applied) -// 16. auto-apply: verification pending→ poll (verification_pending) -// 17. auto-apply: verified → done (fix_auto_applying) -// 18. fix: verification failed/none → done (fix_needs_review) -// 19. fix: all/e2e verified → done (fix_apply_ready) -// 20. fix: needs local verify → done (fix_needs_local_verify) -// 21. self-healing failed → done (fix_failed) -// 22. no fix available → done (no_fix) -// 23. fallback → poll (fallback) +// 16. auto-apply: skipped → done (fix_auto_apply_skipped) +// 17. auto-apply: verification pending→ poll (verification_pending) +// 18. auto-apply: verified → done (fix_auto_applying) +// 19. fix: verification failed/none → done (fix_needs_review) +// 20. fix: all/e2e verified → done (fix_apply_ready) +// 21. fix: needs local verify → done (fix_needs_local_verify) +// 22. self-healing failed → done (fix_failed) +// 23. no fix available → done (no_fix) +// 24. fallback → poll (fallback) // ============================================================ function classify() { @@ -209,6 +212,12 @@ function classify() { // --- Auto-apply path (couldAutoApplyTasks) --- if (couldAutoApplyTasks === true) { + if (autoApplySkipped === true) + return { + action: "done", + code: "fix_auto_apply_skipped", + extra: { autoApplySkipReason }, + }; if (verificationStatus === "NOT_STARTED" || verificationStatus === "IN_PROGRESS") return { action: "poll", code: "verification_pending" }; if (verificationStatus === "COMPLETED") return { action: "done", code: "fix_auto_applying" }; @@ -282,6 +291,10 @@ const messages = { // actionable fix_auto_applying: () => "Fix verified! Auto-applying...", + fix_auto_apply_skipped: (extra) => + `Fix verified but auto-apply was skipped. ${ + extra?.autoApplySkipReason ? `Reason: ${extra.autoApplySkipReason}` : "Offer to apply manually." + }`, fix_needs_review: () => `Fix available but needs review. Verification: ${verificationStatus || "N/A"}`, fix_apply_ready: () => "Fix available and verified. Ready to apply.", fix_needs_local_verify: (extra) => @@ -300,6 +313,7 @@ const messages = { const resetProgressCodes = new Set([ "ci_success", "fix_auto_applying", + "fix_auto_apply_skipped", "fix_needs_review", "fix_apply_ready", "fix_needs_local_verify", @@ -351,6 +365,7 @@ function buildOutput(decision) { // Add extras if (code === "new_cipe_detected") result.newCipeDetected = true; if (extra?.verifiableTaskIds) result.verifiableTaskIds = extra.verifiableTaskIds; + if (extra?.autoApplySkipReason) result.autoApplySkipReason = extra.autoApplySkipReason; console.log(JSON.stringify(result)); } diff --git a/.cursor/skills/nx-import/SKILL.md b/.cursor/skills/nx-import/SKILL.md index a5d078c2f81..b1cd381d3dd 100644 --- a/.cursor/skills/nx-import/SKILL.md +++ b/.cursor/skills/nx-import/SKILL.md @@ -3,13 +3,6 @@ name: nx-import description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. --- ---- - -name: nx-import -description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. - ---- - ## Quick Start - `nx import` brings code from a source repository or folder into the current workspace, preserving commit history. @@ -44,6 +37,25 @@ Read the nx docs if you have the tools for it. - **Always prefer the destination's existing conventions.** Source uses `libs/`but dest uses `packages/`? Import into `packages/` (`nx import packages/foo --source=libs/foo`). - If dest has no convention (empty workspace), ask the user. +### Application vs Library Detection + +Before importing, identify whether the source is an **application** or a **library**: + +- **Applications**: Deployable end products. Common indicators: + - _Frontend_: `next.config.*`, `vite.config.*` with a build entry point, framework-specific app scaffolding (CRA, Angular CLI app, etc.) + - _Backend (Node.js)_: Express/Fastify/NestJS server entrypoint, no `"exports"` field in `package.json` + - _JVM_: Maven `pom.xml` with `jar` or `war` and a `main` class; Gradle `application` plugin or `mainClass` setting + - _.NET_: `.csproj`/`.fsproj` with `Exe` or `WinExe` + - _General_: Dockerfile, a runnable entrypoint, no public API surface intended for import by other projects +- **Libraries**: Reusable packages consumed by other projects. Common indicators: `"main"`/`"exports"` in `package.json`, Maven/Gradle packaging as a library jar, .NET `Library`, named exports intended for import by other packages. + +**Destination directory rules**: + +- Applications → `apps/`. Check workspace globs (e.g. `pnpm-workspace.yaml`, `workspaces` in root `package.json`) for an existing `apps/*` entry. + - If `apps/*` is **not** present, add it before importing: update the workspace glob config and commit (or stage) the change. + - Example: `nx import apps/my-app --source=packages/my-app` +- Libraries → follow the dest's existing convention (`packages/`, `libs/`, etc.). + ## Common Issues ### pnpm Workspace Globs (Critical) @@ -218,6 +230,7 @@ Identify technologies in the source repo, then read and apply the matching refer Available references: +- `references/ESLINT.md` — ESLint projects: duplicate `lint`/`eslint:lint` targets, legacy `.eslintrc.*` linting generated files, flat config `.cjs` self-linting, `typescript-eslint` v7/v9 peer dep conflict, mixed ESLint v8+v9 in one workspace. - `references/GRADLE.md` - `references/JEST.md` — Jest testing: `@nx/jest/plugin` setup, jest.preset.js, testing deps by framework, tsconfig.spec.json, Jest vs Vitest coexistence, Babel transforms, CI atomization. - `references/NEXT.md` — Next.js projects: `@nx/next/plugin` targets, `withNx`, Next.js TS config (`noEmit`, `jsx: "preserve"`), auto-installing deps via wrong PM, non-Nx `create-next-app` imports, mixed Next.js+Vite coexistence. diff --git a/.cursor/skills/nx-import/references/ESLINT.md b/.cursor/skills/nx-import/references/ESLINT.md new file mode 100644 index 00000000000..0d4afb8d9d0 --- /dev/null +++ b/.cursor/skills/nx-import/references/ESLINT.md @@ -0,0 +1,109 @@ +## ESLint + +ESLint-specific guidance for `nx import`. For generic import issues (root deps, pnpm globs, project references), see `SKILL.md`. + +--- + +### How `@nx/eslint/plugin` Works + +`@nx/eslint/plugin` scans for ESLint config files and creates a lint target for each project. It detects **both** flat config files (`eslint.config.{js,mjs,cjs,ts,mts,cts}`) and legacy config files (`.eslintrc.{json,js,cjs,mjs,yml,yaml}`). + +**Plugin options (set during `nx add @nx/eslint`):** + +```json +{ + "plugin": "@nx/eslint/plugin", + "options": { + "targetName": "eslint:lint" + } +} +``` + +**Auto-installation**: `nx import` auto-detects ESLint config files and offers to install `@nx/eslint`. Accept the offer — it registers the plugin and updates `namedInputs.production` to exclude ESLint config files. + +--- + +### Duplicate `lint` and `eslint:lint` Targets + +After import, projects will have **two** lint-related targets if the source `package.json` has a `"lint"` npm script: + +- `eslint:lint` — inferred by `@nx/eslint/plugin`; has proper caching and input/output tracking +- `lint` — created by Nx from the npm script via `nx:run-script`; no caching intelligence, just wraps `npm run lint` + +**Fix**: Remove the `"lint"` script from each project's `package.json`. Keep `"lint:fix"` if present — there is no plugin-inferred equivalent for auto-fixing. + +--- + +### Legacy `.eslintrc.*` Configs Linting Generated Files + +When `@nx/eslint/plugin` runs `eslint .` on a project with a legacy `.eslintrc.*` config that uses `parserOptions.project`, it tries to lint **all** files in the project directory including: + +- Generated `dist/**/*.d.ts` files (not in tsconfig `include`) +- The `.eslintrc.js` config file itself (not in tsconfig `include`) + +This causes `Parsing error: ESLint was configured to run on X using parserOptions.project, however that TSConfig does not include this file`. + +**Fix**: Add `ignorePatterns` to the `.eslintrc.*` config: + +```json +// .eslintrc.json +{ + "ignorePatterns": ["dist/**"] +} +``` + +```js +// .eslintrc.js — also ignore the config file itself since module.exports isn't in tsconfig +module.exports = { + ignorePatterns: ["dist/**", ".eslintrc.js"], + // ... +}; +``` + +--- + +### Flat Config `.cjs` Files Self-Linting + +When a project uses `eslint.config.cjs` (CJS flat config), `eslint .` lints the config file itself. The `require()` call on line 1 triggers `@typescript-eslint/no-require-imports`. + +**Fix**: Add the config filename to the top-level `ignores` array: + +```js +module.exports = tseslint.config( + { + ignores: ["dist/**", "node_modules/**", "eslint.config.cjs"], + }, + // ... +); +``` + +The same applies to `eslint.config.js` in a CJS project (no `"type": "module"`) if it uses `require()`. + +--- + +### `typescript-eslint` Version Conflict With ESLint 9 + +`typescript-eslint@7.x` declares `peerDependencies: { "eslint": "^8.56.0" }`, but it is commonly used alongside `"eslint": "^9.0.0"`. npm treats this as a hard peer dep conflict and refuses to install. + +**Root cause**: `@nx/eslint` init adds `eslint@~8.57.0` at the workspace root (for its own peer deps). Workspace packages that request `eslint@^9.0.0` + `typescript-eslint@^7.0.0` trigger the conflict when npm resolves their deps. + +**Fix**: Upgrade `typescript-eslint` from `^7.0.0` to `^8.0.0` directly in the affected workspace package's `package.json`. The `tseslint.config()` API and `tseslint.configs.recommended` are identical between v7 and v8 — no config changes needed. + +```json +// packages/my-package/package.json +{ + "devDependencies": { + "typescript-eslint": "^8.0.0" + } +} +``` + +**Note**: npm's root-level `"overrides"` field does not force versions for workspace packages' direct dependencies — update each package.json individually. + +--- + +### Mixed ESLint v8 and v9 in One Workspace + +Legacy v8 and flat-config v9 packages can coexist in the same workspace. Each package resolves its own `eslint` version. The root `eslint@~8.57.0` (added by `@nx/eslint` init) is used by legacy v8 packages; v9 packages get their own hoisted `eslint@9`. + +`@nx/eslint/plugin` infers `eslint:lint` targets for **both** config formats. Legacy packages run ESLint v8 with `.eslintrc.*`; flat-config packages run ESLint v9 with `eslint.config.*`. No special nx.json configuration is needed to support both simultaneously. diff --git a/.cursor/skills/nx-import/references/NEXT.md b/.cursor/skills/nx-import/references/NEXT.md index 12466d6ba5f..d9ec1f0b557 100644 --- a/.cursor/skills/nx-import/references/NEXT.md +++ b/.cursor/skills/nx-import/references/NEXT.md @@ -54,6 +54,20 @@ Next.js app tsconfigs have unique patterns compared to Vite: Imported Next.js configs may have `// eslint-disable-next-line @typescript-eslint/no-var-requires` but the project ESLint config enables different rule sets. This produces `Unused eslint-disable directive` warnings. Harmless — remove the comment or ignore. +### `@nx/next:init` Rewrites All npm Scripts (Whole-Repo Import) + +When `@nx/next:init` runs during a whole-repo import, it rewrites the project's `package.json` scripts to prefixed `nx` calls: + +```json +{ + "dev": "nx next:dev", + "build": "nx next:build", + "start": "nx next:start" +} +``` + +This is the standard "npm Script Rewriting" issue from SKILL.md, but triggered by `@nx/next:init` rather than Nx init. **Fix**: Remove all rewritten scripts from `package.json` — `@nx/next/plugin` infers all targets from `next.config.*`. + --- ## Non-Nx Source (create-next-app) @@ -66,6 +80,10 @@ For single-project `create-next-app` repos, use whole-repo import into a subdire nx import /path/to/source apps/web --ref=main --source=. --no-interactive ``` +### `next-env.d.ts` + +`next build` auto-generates `next-env.d.ts` at the project root. Add `next-env.d.ts` to the dest root `.gitignore` — it is framework-generated and should not be committed. + ### ESLint: Self-Contained `eslint-config-next` `create-next-app` generates a flat ESLint config using `eslint-config-next` (which bundles its own plugins). This is **self-contained** — no root `eslint.config.mjs` needed, no `@nx/eslint-plugin` dependency. The `@nx/eslint/plugin` detects it and creates a lint target. @@ -123,17 +141,19 @@ No naming conflicts between frameworks. ## Fix Order — Nx Source (Subdirectory Import) -1. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) -2. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` -3. ESLint setup (see SKILL.md: "Root ESLint Config Missing") -4. Jest setup (see SKILL.md: "Jest Preset Missing") -5. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` +1. Import Next.js apps into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) +3. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` +4. ESLint setup (see SKILL.md: "Root ESLint Config Missing") +5. Jest setup (see SKILL.md: "Jest Preset Missing") +6. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` ## Fix Order — Non-Nx Source (create-next-app) -1. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) -2. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) -3. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) +1. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) +3. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) +4. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) --- @@ -168,6 +188,16 @@ No naming conflicts between frameworks. - No test setup (create-next-app doesn't include tests) - All targets green: next:build, eslint:lint +### Scenario 4: Non-Nx create-next-app (alongside Vite, React Router 7, TanStack, CRA) → TS preset (PASS) + +- See VITE.md Scenario 6 for the full multi-import scenario +- Next.js-specific findings: + 1. `@nx/next:init` rewrote all scripts to `nx next:*` format — removed all rewritten scripts + 2. Stale files: `node_modules/`, `package-lock.json`, `.gitignore` — deleted (npm workspace, no pnpm files) + 3. ESLint self-contained via `eslint-config-next` — no root config needed + 4. No tsconfig changes needed — `noEmit: true` stays; `next build` handles type checking +- Targets: `next:build`, `next:dev`, `next:start`, `eslint:lint` + ### Scenario 5: Mixed Next.js (Nx) + Vite React (standalone) → TS preset (PASS) - Source A: CNW next preset (Next.js 16, App Router) — subdirectory import of `apps/` diff --git a/.cursor/skills/nx-import/references/VITE.md b/.cursor/skills/nx-import/references/VITE.md index 58ea909c6eb..5b3817eba42 100644 --- a/.cursor/skills/nx-import/references/VITE.md +++ b/.cursor/skills/nx-import/references/VITE.md @@ -43,6 +43,71 @@ See SKILL.md for the generic noEmit→composite fix. Vite-specific additions: --- +## React Router 7 (Vite-Based) + +React Router 7 (`@react-router/dev`) uses Vite under the hood with a `vite.config.ts` and a `react-router.config.ts`. The `@nx/vite/plugin` detects `vite.config.ts` and creates inferred targets. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `serve` targets. The `build` target invokes the script defined in `package.json` (usually `react-router build`), not `vite build` directly. + +**No separate typecheck target from `@nx/vite/plugin`** — React Router 7 typegen is run as part of `typecheck` (e.g. `react-router typegen && tsc`). The `typecheck` target is inferred from the tsconfig. Keep the `typecheck` script in `package.json` if present; it is not rewritten. + +### tsconfig Notes + +React Router 7 uses a single `tsconfig.json` (no `tsconfig.app.json`/`tsconfig.node.json` split). It includes: + +- `"rootDirs": [".", "./.react-router/types"]` — for generated type files; keep as-is +- `"paths": { "~/*": ["./app/*"] }` — self-referential alias; keep as-is +- `"noEmit": true` — replace with composite settings per SKILL.md + +### Build Output + +React Router 7 outputs to `build/` (not `dist/`). Add `build` to the dest root `.gitignore`. + +### Generated Types Directory + +React Router 7 generates `.react-router/` at the project root for route type generation. Add `.react-router` to the dest root `.gitignore`. + +--- + +## TanStack Start (Vite-Based) + +TanStack Start uses Vinxi under the hood, which wraps Vite. Projects have a standard `vite.config.ts` that `@nx/vite/plugin` detects normally. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `preview`, `serve-static`, `typecheck` targets. The `build` target runs `vite build` which invokes the TanStack Start Vinxi pipeline (produces both client and SSR bundles). + +### tsconfig Notes + +TanStack Start uses a single `tsconfig.json` with `"allowImportingTsExtensions": true` and `"noEmit": true`. Apply the standard noEmit → composite fix. `allowImportingTsExtensions` is compatible with `emitDeclarationOnly: true` — no change needed. + +### `paths` Aliases + +TanStack Start commonly uses `"#/*": ["./src/*"]` and `"@/*": ["./src/*"]`. These are self-referential — keep as-is for a single-project app. + +### Uncommitted Source Repo + +`create-tan-stack` initializes a git repo but does NOT make an initial commit. Before importing, commit first: + +```bash +git -C /path/to/source add . && git -C /path/to/source commit -m "Initial commit" +``` + +### Generated and Build Directories + +TanStack Start / Vinxi / Nitro generate several directories that must be added to the dest root `.gitignore`: + +- `.vinxi` — Vinxi build cache +- `.tanstack` — TanStack generated files +- `.nitro` — Nitro build artifacts +- `.output` — server-side build output (SSR/edge) + +These are not covered by `dist` or `build`. + +--- + ## React-Specific ### React Dependencies @@ -195,6 +260,42 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t --- +## Redundant npm Scripts After Import + +`nx import` copies `package.json` verbatim, so npm scripts come along. For Vite-based projects `@nx/vite/plugin` already infers the same targets from `vite.config.ts` — the npm scripts just shadow the plugin with weaker `nx:run-script` wrappers (no first-class caching inputs/outputs). Remove them after import. + +### Standalone Vite App (`create-vite`) + +Remove the following scripts — every one is redundant: + +| Script | Plugin replacement | +| ----------------------------- | ---------------------------------------------------------------------------- | +| `dev: vite` | `@nx/vite/plugin` → `dev` | +| `build: tsc -b && vite build` | `@nx/vite/plugin` → `build`; `typecheck` via `@nx/js/typescript` handles tsc | +| `preview: vite preview` | `@nx/vite/plugin` → `preview` | +| `lint: eslint .` | `@nx/eslint/plugin` → `eslint:lint` | + +### TanStack Start + +Remove `build`, `dev`, `preview`, and `test` scripts, but move any hardcoded `--port` flag to `vite.config.ts` first: + +```ts +// vite.config.ts +export default defineConfig({ + server: { port: 3000 }, // replaces `vite dev --port 3000` + ... +}) +``` + +### React Router 7 — Keep ALL scripts + +Do **not** remove React Router 7 scripts. They use the framework CLI (`react-router build`, `react-router dev`, `react-router-serve`) which is not interchangeable with plain `vite`: + +- `typecheck` runs `react-router typegen && tsc` — typegen must precede `tsc` or it fails on missing route types +- `start` serves the SSR bundle — no plugin equivalent + +--- + ## Fix Orders ### Nx Source @@ -208,19 +309,43 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t ### Non-Nx Source (additional steps) +0. Import into `apps/` (see SKILL.md: "Application vs Library Detection") 1. Generic fixes from SKILL.md (stale files cleanup, pnpm globs, rewritten scripts, target name prefixing, noEmit→composite, ESLint handling) 2. Fix `noEmit` in **all** tsconfigs (app, node, etc. — non-Nx projects often have multiple) 3. Add `extends` to solution-style tsconfigs so root settings apply 4. Fix `resolve.alias` / `__dirname` / `baseUrl` 5. Ensure `types` include `vite/client` and `node` 6. Install `@nx/vite` manually if it failed during import -7. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores -8. Full verification +7. Remove redundant npm scripts so `@nx/vite/plugin` infers them natively (see "Redundant npm Scripts" section) +8. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores +9. Full verification ### Multiple-Source Imports See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific: fix tsconfig `references` paths for alternate directories (`../../libs/` → `../../libs-beta/`). +### Non-Nx Source: React Router 7 + +1. Ensure source has at least one commit (see SKILL.md: "Source Repo Has No Commits") +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/react` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Add `build` and `.react-router` to dest root `.gitignore` +6. **Keep all npm scripts** — React Router 7 uses framework CLI (`react-router build/dev`), not plain vite (see "Redundant npm Scripts" above) +7. `npm install && nx reset && nx sync --yes` + +### Non-Nx Source: TanStack Start + +1. Ensure source has at least one commit — `create-tan-stack` does NOT auto-commit (see SKILL.md) +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/vitest` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Keep `allowImportingTsExtensions` — compatible with `emitDeclarationOnly: true` +6. Add `.vinxi`, `.tanstack`, `.nitro`, `.output` to dest root `.gitignore` +7. Move hardcoded `--port` from `dev` script into `vite.config.ts` (`server: { port: N }`) +8. Remove redundant npm scripts — `@nx/vite/plugin` infers `build`, `dev`, `preview`, `test` (see "Redundant npm Scripts" above) +9. `npm install && nx reset && nx sync --yes` + ### Quick Reference: React vs Vue | Aspect | React | Vue | @@ -232,3 +357,41 @@ See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific | ESLint parser | Standard TS | `vue-eslint-parser` + TS sub-parser | | ESLint setup | Straightforward | Must install deps before `@nx/eslint` | | Test utils | `@testing-library/react` | `@vue/test-utils` | + +### Quick Reference: Vite-Based React Frameworks + +| Aspect | Vite (standalone) | React Router 7 | TanStack Start | +| ------------------ | ----------------- | ----------------------- | ------------------------ | +| Build config | `vite.config.ts` | `vite.config.ts` | `vite.config.ts` | +| Build output | `dist/` | `build/` | `dist/` | +| SSR bundle | No | Yes (`build/server/`) | Yes (`dist/server/`) | +| tsconfig layout | app + node split | Single tsconfig | Single tsconfig | +| Auto-committed | Depends on tool | Usually yes | **No — commit first** | +| `nx import` plugin | `@nx/vite` | `@nx/vite`, `@nx/react` | `@nx/vite`, `@nx/vitest` | + +--- + +## Iteration Log + +### Scenario 6: Multiple non-Nx React apps (CRA, Next.js, React Router 7, TanStack Start, Vite) → TS preset (PASS) + +- Sources: 5 standalone non-Nx repos with different build tools +- Dest: CNW ts preset (Nx 22.5.1), npm workspaces, `packages/*` +- Import: whole-repo for each, sequential into `packages/` +- Pre-import fixes: + 1. Removed `packages/.gitkeep` and committed + 2. `git init && git add . && git commit` in Vite app (no git at all) + 3. `git add . && git commit` in TanStack app (git init'd but no commits) +- Import: `npm exec nx -- import packages/ --source=. --ref=main --no-interactive` + - Next.js import auto-installed `@nx/eslint`, `@nx/next` + - React Router 7 import auto-installed `@nx/vite`, `@nx/react`, `@nx/docker` (Dockerfile present) + - TanStack import auto-installed `@nx/vitest` +- Post-import fixes: + 1. Removed stale `node_modules/`, `package-lock.json`, `.gitignore` from each package + 2. Removed Nx-rewritten scripts from `board-games-nextjs/package.json` (had `"build": "nx next:build"`, etc.) + 3. Updated root `tsconfig.base.json`: `nodenext` → `bundler`, added `dom`/`dom.iterable` to lib, added `jsx: react-jsx` + 4. Added `build` to dest root `.gitignore` (CRA and React Router 7 output there) + 5. Fixed `noEmit` → `composite + emitDeclarationOnly` in: `board-games-vite/tsconfig.app.json`, `board-games-vite/tsconfig.node.json`, `board-games-react-router/tsconfig.json`, `board-games-tanstack/tsconfig.json` + 6. Fixed `tsBuildInfoFile` paths from `./node_modules/.tmp/...` to `./dist/...` + 7. Installed root `@types/react`, `@types/react-dom`, `@types/node` +- All targets green: `build` for all 5 projects; `typecheck` for Vite/React Router/TanStack; `next:build` for Next.js diff --git a/.cursor/skills/nx-workspace/SKILL.md b/.cursor/skills/nx-workspace/SKILL.md index ecd7aec061e..2b01d45353e 100644 --- a/.cursor/skills/nx-workspace/SKILL.md +++ b/.cursor/skills/nx-workspace/SKILL.md @@ -60,7 +60,6 @@ nx show project my-app --json | jq '.targets' nx show project my-app --json | jq '.targets.build' nx show project my-app --json | jq '.targets | keys' - # Check project metadata nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' ``` diff --git a/.gemini/commands/monitor-ci.toml b/.gemini/commands/monitor-ci.toml index d7931affb32..d8188067911 100644 --- a/.gemini/commands/monitor-ci.toml +++ b/.gemini/commands/monitor-ci.toml @@ -1,4 +1,4 @@ -description = "Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says \"monitor ci\", \"watch ci\", \"ci monitor\", \"watch ci for this branch\", \"track ci\", \"check ci status\", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring." +description = "Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says \"monitor ci\", \"watch ci\", \"ci monitor\", \"watch ci for this branch\", \"track ci\", \"check ci status\", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access." prompt = """ # Monitor CI Command @@ -33,7 +33,7 @@ Parse any overrides from `{{args}}` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -60,9 +60,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -74,53 +74,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - 'cipeUrl,commitSha,cipeStatus' - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: 'cipeUrl,commitSha,cipeStatus' +LIGHT_FIELDS: 'cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage' +HEAVY_FIELDS: 'taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription' +``` -LIGHT_FIELDS: - 'cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage' - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - 'taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription' - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -128,128 +102,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -284,16 +167,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -347,16 +221,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.gemini/skills/monitor-ci/references/fix-flows.md b/.gemini/skills/monitor-ci/references/fix-flows.md new file mode 100644 index 00000000000..b33aa02167b --- /dev/null +++ b/.gemini/skills/monitor-ci/references/fix-flows.md @@ -0,0 +1,108 @@ +# Detailed Status Handling & Fix Flows + +## Status Handling by Code + +### fix_auto_apply_skipped + +The script returns `autoApplySkipReason` in its output. + +1. Report the skip reason to the user (e.g., "Auto-apply was skipped because the previous CI pipeline execution was triggered by Nx Cloud") +2. Offer to apply the fix manually — spawn UPDATE_FIX subagent with `APPLY` if user agrees +3. Record `last_cipe_url`, enter wait mode + +### fix_apply_ready + +- Spawn UPDATE_FIX subagent with `APPLY` +- Record `last_cipe_url`, enter wait mode + +### fix_needs_local_verify + +The script returns `verifiableTaskIds` in its output. + +1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` +2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task +3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode +4. **If any fail** → Apply Locally + Enhance Flow (see below) + +### fix_needs_review + +Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): + +- If fix looks correct → apply via MCP +- If fix needs enhancement → Apply Locally + Enhance Flow +- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow + +### fix_failed / no_fix + +Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. + +### environment_issue + +1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` +3. Enter wait mode with `last_cipe_url` set + +### self_healing_throttled + +Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. + +1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) +2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` +3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. +4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode + +### no_new_cipe + +1. Report to user: no CI attempt found, suggest checking CI provider +2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode +3. Otherwise: exit with guidance + +### cipe_no_tasks + +1. Report to user: CI failed with no tasks recorded +2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode +3. If retry also returns `cipe_no_tasks`: exit with failure + +## Fix Action Flows + +### Apply via MCP + +Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. + +### Apply Locally + Enhance Flow + +1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) +2. Enhance code to fix failing tasks +3. Run failing tasks to verify +4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. +5. If passing → commit and push, enter wait mode + +### Reject + Fix From Scratch Flow + +1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `REJECT` +3. Fix from scratch locally +4. Commit and push, enter wait mode + +## Environment vs Code Failure Recognition + +When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. + +**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. + +When detected → bail immediately without running gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. + +**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. + +## Git Safety + +- Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets + +## Commit Message Format + +```bash +git commit -m "fix(): + +Failed tasks: , +Local verification: passed|enhanced|failed-pushing-to-ci" +``` diff --git a/.gemini/skills/monitor-ci/scripts/ci-poll-decide.mjs b/.gemini/skills/monitor-ci/scripts/ci-poll-decide.mjs index d14b54df090..5a296493320 100644 --- a/.gemini/skills/monitor-ci/scripts/ci-poll-decide.mjs +++ b/.gemini/skills/monitor-ci/scripts/ci-poll-decide.mjs @@ -76,6 +76,8 @@ const { failedTaskIds = [], verifiedTaskIds = [], couldAutoApplyTasks, + autoApplySkipped, + autoApplySkipReason, userAction, cipeUrl, commitSha, @@ -154,14 +156,15 @@ function isNewCipe() { // 13. self-healing in progress → poll (sh_running) // 14. flaky task auto-rerun → poll (flaky_rerun) // 15. fix auto-applied → poll (fix_auto_applied) -// 16. auto-apply: verification pending→ poll (verification_pending) -// 17. auto-apply: verified → done (fix_auto_applying) -// 18. fix: verification failed/none → done (fix_needs_review) -// 19. fix: all/e2e verified → done (fix_apply_ready) -// 20. fix: needs local verify → done (fix_needs_local_verify) -// 21. self-healing failed → done (fix_failed) -// 22. no fix available → done (no_fix) -// 23. fallback → poll (fallback) +// 16. auto-apply: skipped → done (fix_auto_apply_skipped) +// 17. auto-apply: verification pending→ poll (verification_pending) +// 18. auto-apply: verified → done (fix_auto_applying) +// 19. fix: verification failed/none → done (fix_needs_review) +// 20. fix: all/e2e verified → done (fix_apply_ready) +// 21. fix: needs local verify → done (fix_needs_local_verify) +// 22. self-healing failed → done (fix_failed) +// 23. no fix available → done (no_fix) +// 24. fallback → poll (fallback) // ============================================================ function classify() { @@ -209,6 +212,12 @@ function classify() { // --- Auto-apply path (couldAutoApplyTasks) --- if (couldAutoApplyTasks === true) { + if (autoApplySkipped === true) + return { + action: "done", + code: "fix_auto_apply_skipped", + extra: { autoApplySkipReason }, + }; if (verificationStatus === "NOT_STARTED" || verificationStatus === "IN_PROGRESS") return { action: "poll", code: "verification_pending" }; if (verificationStatus === "COMPLETED") return { action: "done", code: "fix_auto_applying" }; @@ -282,6 +291,10 @@ const messages = { // actionable fix_auto_applying: () => "Fix verified! Auto-applying...", + fix_auto_apply_skipped: (extra) => + `Fix verified but auto-apply was skipped. ${ + extra?.autoApplySkipReason ? `Reason: ${extra.autoApplySkipReason}` : "Offer to apply manually." + }`, fix_needs_review: () => `Fix available but needs review. Verification: ${verificationStatus || "N/A"}`, fix_apply_ready: () => "Fix available and verified. Ready to apply.", fix_needs_local_verify: (extra) => @@ -300,6 +313,7 @@ const messages = { const resetProgressCodes = new Set([ "ci_success", "fix_auto_applying", + "fix_auto_apply_skipped", "fix_needs_review", "fix_apply_ready", "fix_needs_local_verify", @@ -351,6 +365,7 @@ function buildOutput(decision) { // Add extras if (code === "new_cipe_detected") result.newCipeDetected = true; if (extra?.verifiableTaskIds) result.verifiableTaskIds = extra.verifiableTaskIds; + if (extra?.autoApplySkipReason) result.autoApplySkipReason = extra.autoApplySkipReason; console.log(JSON.stringify(result)); } diff --git a/.gemini/skills/monitor-ci/skill.md b/.gemini/skills/monitor-ci/skill.md index fe56ccedd35..a4af6cbb556 100644 --- a/.gemini/skills/monitor-ci/skill.md +++ b/.gemini/skills/monitor-ci/skill.md @@ -1,6 +1,6 @@ --- name: monitor-ci -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. --- # Monitor CI Command @@ -36,7 +36,7 @@ Parse any overrides from `$ARGUMENTS` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.gemini/skills/nx-import/references/ESLINT.md b/.gemini/skills/nx-import/references/ESLINT.md new file mode 100644 index 00000000000..0d4afb8d9d0 --- /dev/null +++ b/.gemini/skills/nx-import/references/ESLINT.md @@ -0,0 +1,109 @@ +## ESLint + +ESLint-specific guidance for `nx import`. For generic import issues (root deps, pnpm globs, project references), see `SKILL.md`. + +--- + +### How `@nx/eslint/plugin` Works + +`@nx/eslint/plugin` scans for ESLint config files and creates a lint target for each project. It detects **both** flat config files (`eslint.config.{js,mjs,cjs,ts,mts,cts}`) and legacy config files (`.eslintrc.{json,js,cjs,mjs,yml,yaml}`). + +**Plugin options (set during `nx add @nx/eslint`):** + +```json +{ + "plugin": "@nx/eslint/plugin", + "options": { + "targetName": "eslint:lint" + } +} +``` + +**Auto-installation**: `nx import` auto-detects ESLint config files and offers to install `@nx/eslint`. Accept the offer — it registers the plugin and updates `namedInputs.production` to exclude ESLint config files. + +--- + +### Duplicate `lint` and `eslint:lint` Targets + +After import, projects will have **two** lint-related targets if the source `package.json` has a `"lint"` npm script: + +- `eslint:lint` — inferred by `@nx/eslint/plugin`; has proper caching and input/output tracking +- `lint` — created by Nx from the npm script via `nx:run-script`; no caching intelligence, just wraps `npm run lint` + +**Fix**: Remove the `"lint"` script from each project's `package.json`. Keep `"lint:fix"` if present — there is no plugin-inferred equivalent for auto-fixing. + +--- + +### Legacy `.eslintrc.*` Configs Linting Generated Files + +When `@nx/eslint/plugin` runs `eslint .` on a project with a legacy `.eslintrc.*` config that uses `parserOptions.project`, it tries to lint **all** files in the project directory including: + +- Generated `dist/**/*.d.ts` files (not in tsconfig `include`) +- The `.eslintrc.js` config file itself (not in tsconfig `include`) + +This causes `Parsing error: ESLint was configured to run on X using parserOptions.project, however that TSConfig does not include this file`. + +**Fix**: Add `ignorePatterns` to the `.eslintrc.*` config: + +```json +// .eslintrc.json +{ + "ignorePatterns": ["dist/**"] +} +``` + +```js +// .eslintrc.js — also ignore the config file itself since module.exports isn't in tsconfig +module.exports = { + ignorePatterns: ["dist/**", ".eslintrc.js"], + // ... +}; +``` + +--- + +### Flat Config `.cjs` Files Self-Linting + +When a project uses `eslint.config.cjs` (CJS flat config), `eslint .` lints the config file itself. The `require()` call on line 1 triggers `@typescript-eslint/no-require-imports`. + +**Fix**: Add the config filename to the top-level `ignores` array: + +```js +module.exports = tseslint.config( + { + ignores: ["dist/**", "node_modules/**", "eslint.config.cjs"], + }, + // ... +); +``` + +The same applies to `eslint.config.js` in a CJS project (no `"type": "module"`) if it uses `require()`. + +--- + +### `typescript-eslint` Version Conflict With ESLint 9 + +`typescript-eslint@7.x` declares `peerDependencies: { "eslint": "^8.56.0" }`, but it is commonly used alongside `"eslint": "^9.0.0"`. npm treats this as a hard peer dep conflict and refuses to install. + +**Root cause**: `@nx/eslint` init adds `eslint@~8.57.0` at the workspace root (for its own peer deps). Workspace packages that request `eslint@^9.0.0` + `typescript-eslint@^7.0.0` trigger the conflict when npm resolves their deps. + +**Fix**: Upgrade `typescript-eslint` from `^7.0.0` to `^8.0.0` directly in the affected workspace package's `package.json`. The `tseslint.config()` API and `tseslint.configs.recommended` are identical between v7 and v8 — no config changes needed. + +```json +// packages/my-package/package.json +{ + "devDependencies": { + "typescript-eslint": "^8.0.0" + } +} +``` + +**Note**: npm's root-level `"overrides"` field does not force versions for workspace packages' direct dependencies — update each package.json individually. + +--- + +### Mixed ESLint v8 and v9 in One Workspace + +Legacy v8 and flat-config v9 packages can coexist in the same workspace. Each package resolves its own `eslint` version. The root `eslint@~8.57.0` (added by `@nx/eslint` init) is used by legacy v8 packages; v9 packages get their own hoisted `eslint@9`. + +`@nx/eslint/plugin` infers `eslint:lint` targets for **both** config formats. Legacy packages run ESLint v8 with `.eslintrc.*`; flat-config packages run ESLint v9 with `eslint.config.*`. No special nx.json configuration is needed to support both simultaneously. diff --git a/.gemini/skills/nx-import/references/NEXT.md b/.gemini/skills/nx-import/references/NEXT.md index 12466d6ba5f..d9ec1f0b557 100644 --- a/.gemini/skills/nx-import/references/NEXT.md +++ b/.gemini/skills/nx-import/references/NEXT.md @@ -54,6 +54,20 @@ Next.js app tsconfigs have unique patterns compared to Vite: Imported Next.js configs may have `// eslint-disable-next-line @typescript-eslint/no-var-requires` but the project ESLint config enables different rule sets. This produces `Unused eslint-disable directive` warnings. Harmless — remove the comment or ignore. +### `@nx/next:init` Rewrites All npm Scripts (Whole-Repo Import) + +When `@nx/next:init` runs during a whole-repo import, it rewrites the project's `package.json` scripts to prefixed `nx` calls: + +```json +{ + "dev": "nx next:dev", + "build": "nx next:build", + "start": "nx next:start" +} +``` + +This is the standard "npm Script Rewriting" issue from SKILL.md, but triggered by `@nx/next:init` rather than Nx init. **Fix**: Remove all rewritten scripts from `package.json` — `@nx/next/plugin` infers all targets from `next.config.*`. + --- ## Non-Nx Source (create-next-app) @@ -66,6 +80,10 @@ For single-project `create-next-app` repos, use whole-repo import into a subdire nx import /path/to/source apps/web --ref=main --source=. --no-interactive ``` +### `next-env.d.ts` + +`next build` auto-generates `next-env.d.ts` at the project root. Add `next-env.d.ts` to the dest root `.gitignore` — it is framework-generated and should not be committed. + ### ESLint: Self-Contained `eslint-config-next` `create-next-app` generates a flat ESLint config using `eslint-config-next` (which bundles its own plugins). This is **self-contained** — no root `eslint.config.mjs` needed, no `@nx/eslint-plugin` dependency. The `@nx/eslint/plugin` detects it and creates a lint target. @@ -123,17 +141,19 @@ No naming conflicts between frameworks. ## Fix Order — Nx Source (Subdirectory Import) -1. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) -2. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` -3. ESLint setup (see SKILL.md: "Root ESLint Config Missing") -4. Jest setup (see SKILL.md: "Jest Preset Missing") -5. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` +1. Import Next.js apps into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) +3. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` +4. ESLint setup (see SKILL.md: "Root ESLint Config Missing") +5. Jest setup (see SKILL.md: "Jest Preset Missing") +6. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` ## Fix Order — Non-Nx Source (create-next-app) -1. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) -2. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) -3. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) +1. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) +3. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) +4. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) --- @@ -168,6 +188,16 @@ No naming conflicts between frameworks. - No test setup (create-next-app doesn't include tests) - All targets green: next:build, eslint:lint +### Scenario 4: Non-Nx create-next-app (alongside Vite, React Router 7, TanStack, CRA) → TS preset (PASS) + +- See VITE.md Scenario 6 for the full multi-import scenario +- Next.js-specific findings: + 1. `@nx/next:init` rewrote all scripts to `nx next:*` format — removed all rewritten scripts + 2. Stale files: `node_modules/`, `package-lock.json`, `.gitignore` — deleted (npm workspace, no pnpm files) + 3. ESLint self-contained via `eslint-config-next` — no root config needed + 4. No tsconfig changes needed — `noEmit: true` stays; `next build` handles type checking +- Targets: `next:build`, `next:dev`, `next:start`, `eslint:lint` + ### Scenario 5: Mixed Next.js (Nx) + Vite React (standalone) → TS preset (PASS) - Source A: CNW next preset (Next.js 16, App Router) — subdirectory import of `apps/` diff --git a/.gemini/skills/nx-import/references/VITE.md b/.gemini/skills/nx-import/references/VITE.md index 58ea909c6eb..5b3817eba42 100644 --- a/.gemini/skills/nx-import/references/VITE.md +++ b/.gemini/skills/nx-import/references/VITE.md @@ -43,6 +43,71 @@ See SKILL.md for the generic noEmit→composite fix. Vite-specific additions: --- +## React Router 7 (Vite-Based) + +React Router 7 (`@react-router/dev`) uses Vite under the hood with a `vite.config.ts` and a `react-router.config.ts`. The `@nx/vite/plugin` detects `vite.config.ts` and creates inferred targets. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `serve` targets. The `build` target invokes the script defined in `package.json` (usually `react-router build`), not `vite build` directly. + +**No separate typecheck target from `@nx/vite/plugin`** — React Router 7 typegen is run as part of `typecheck` (e.g. `react-router typegen && tsc`). The `typecheck` target is inferred from the tsconfig. Keep the `typecheck` script in `package.json` if present; it is not rewritten. + +### tsconfig Notes + +React Router 7 uses a single `tsconfig.json` (no `tsconfig.app.json`/`tsconfig.node.json` split). It includes: + +- `"rootDirs": [".", "./.react-router/types"]` — for generated type files; keep as-is +- `"paths": { "~/*": ["./app/*"] }` — self-referential alias; keep as-is +- `"noEmit": true` — replace with composite settings per SKILL.md + +### Build Output + +React Router 7 outputs to `build/` (not `dist/`). Add `build` to the dest root `.gitignore`. + +### Generated Types Directory + +React Router 7 generates `.react-router/` at the project root for route type generation. Add `.react-router` to the dest root `.gitignore`. + +--- + +## TanStack Start (Vite-Based) + +TanStack Start uses Vinxi under the hood, which wraps Vite. Projects have a standard `vite.config.ts` that `@nx/vite/plugin` detects normally. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `preview`, `serve-static`, `typecheck` targets. The `build` target runs `vite build` which invokes the TanStack Start Vinxi pipeline (produces both client and SSR bundles). + +### tsconfig Notes + +TanStack Start uses a single `tsconfig.json` with `"allowImportingTsExtensions": true` and `"noEmit": true`. Apply the standard noEmit → composite fix. `allowImportingTsExtensions` is compatible with `emitDeclarationOnly: true` — no change needed. + +### `paths` Aliases + +TanStack Start commonly uses `"#/*": ["./src/*"]` and `"@/*": ["./src/*"]`. These are self-referential — keep as-is for a single-project app. + +### Uncommitted Source Repo + +`create-tan-stack` initializes a git repo but does NOT make an initial commit. Before importing, commit first: + +```bash +git -C /path/to/source add . && git -C /path/to/source commit -m "Initial commit" +``` + +### Generated and Build Directories + +TanStack Start / Vinxi / Nitro generate several directories that must be added to the dest root `.gitignore`: + +- `.vinxi` — Vinxi build cache +- `.tanstack` — TanStack generated files +- `.nitro` — Nitro build artifacts +- `.output` — server-side build output (SSR/edge) + +These are not covered by `dist` or `build`. + +--- + ## React-Specific ### React Dependencies @@ -195,6 +260,42 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t --- +## Redundant npm Scripts After Import + +`nx import` copies `package.json` verbatim, so npm scripts come along. For Vite-based projects `@nx/vite/plugin` already infers the same targets from `vite.config.ts` — the npm scripts just shadow the plugin with weaker `nx:run-script` wrappers (no first-class caching inputs/outputs). Remove them after import. + +### Standalone Vite App (`create-vite`) + +Remove the following scripts — every one is redundant: + +| Script | Plugin replacement | +| ----------------------------- | ---------------------------------------------------------------------------- | +| `dev: vite` | `@nx/vite/plugin` → `dev` | +| `build: tsc -b && vite build` | `@nx/vite/plugin` → `build`; `typecheck` via `@nx/js/typescript` handles tsc | +| `preview: vite preview` | `@nx/vite/plugin` → `preview` | +| `lint: eslint .` | `@nx/eslint/plugin` → `eslint:lint` | + +### TanStack Start + +Remove `build`, `dev`, `preview`, and `test` scripts, but move any hardcoded `--port` flag to `vite.config.ts` first: + +```ts +// vite.config.ts +export default defineConfig({ + server: { port: 3000 }, // replaces `vite dev --port 3000` + ... +}) +``` + +### React Router 7 — Keep ALL scripts + +Do **not** remove React Router 7 scripts. They use the framework CLI (`react-router build`, `react-router dev`, `react-router-serve`) which is not interchangeable with plain `vite`: + +- `typecheck` runs `react-router typegen && tsc` — typegen must precede `tsc` or it fails on missing route types +- `start` serves the SSR bundle — no plugin equivalent + +--- + ## Fix Orders ### Nx Source @@ -208,19 +309,43 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t ### Non-Nx Source (additional steps) +0. Import into `apps/` (see SKILL.md: "Application vs Library Detection") 1. Generic fixes from SKILL.md (stale files cleanup, pnpm globs, rewritten scripts, target name prefixing, noEmit→composite, ESLint handling) 2. Fix `noEmit` in **all** tsconfigs (app, node, etc. — non-Nx projects often have multiple) 3. Add `extends` to solution-style tsconfigs so root settings apply 4. Fix `resolve.alias` / `__dirname` / `baseUrl` 5. Ensure `types` include `vite/client` and `node` 6. Install `@nx/vite` manually if it failed during import -7. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores -8. Full verification +7. Remove redundant npm scripts so `@nx/vite/plugin` infers them natively (see "Redundant npm Scripts" section) +8. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores +9. Full verification ### Multiple-Source Imports See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific: fix tsconfig `references` paths for alternate directories (`../../libs/` → `../../libs-beta/`). +### Non-Nx Source: React Router 7 + +1. Ensure source has at least one commit (see SKILL.md: "Source Repo Has No Commits") +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/react` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Add `build` and `.react-router` to dest root `.gitignore` +6. **Keep all npm scripts** — React Router 7 uses framework CLI (`react-router build/dev`), not plain vite (see "Redundant npm Scripts" above) +7. `npm install && nx reset && nx sync --yes` + +### Non-Nx Source: TanStack Start + +1. Ensure source has at least one commit — `create-tan-stack` does NOT auto-commit (see SKILL.md) +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/vitest` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Keep `allowImportingTsExtensions` — compatible with `emitDeclarationOnly: true` +6. Add `.vinxi`, `.tanstack`, `.nitro`, `.output` to dest root `.gitignore` +7. Move hardcoded `--port` from `dev` script into `vite.config.ts` (`server: { port: N }`) +8. Remove redundant npm scripts — `@nx/vite/plugin` infers `build`, `dev`, `preview`, `test` (see "Redundant npm Scripts" above) +9. `npm install && nx reset && nx sync --yes` + ### Quick Reference: React vs Vue | Aspect | React | Vue | @@ -232,3 +357,41 @@ See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific | ESLint parser | Standard TS | `vue-eslint-parser` + TS sub-parser | | ESLint setup | Straightforward | Must install deps before `@nx/eslint` | | Test utils | `@testing-library/react` | `@vue/test-utils` | + +### Quick Reference: Vite-Based React Frameworks + +| Aspect | Vite (standalone) | React Router 7 | TanStack Start | +| ------------------ | ----------------- | ----------------------- | ------------------------ | +| Build config | `vite.config.ts` | `vite.config.ts` | `vite.config.ts` | +| Build output | `dist/` | `build/` | `dist/` | +| SSR bundle | No | Yes (`build/server/`) | Yes (`dist/server/`) | +| tsconfig layout | app + node split | Single tsconfig | Single tsconfig | +| Auto-committed | Depends on tool | Usually yes | **No — commit first** | +| `nx import` plugin | `@nx/vite` | `@nx/vite`, `@nx/react` | `@nx/vite`, `@nx/vitest` | + +--- + +## Iteration Log + +### Scenario 6: Multiple non-Nx React apps (CRA, Next.js, React Router 7, TanStack Start, Vite) → TS preset (PASS) + +- Sources: 5 standalone non-Nx repos with different build tools +- Dest: CNW ts preset (Nx 22.5.1), npm workspaces, `packages/*` +- Import: whole-repo for each, sequential into `packages/` +- Pre-import fixes: + 1. Removed `packages/.gitkeep` and committed + 2. `git init && git add . && git commit` in Vite app (no git at all) + 3. `git add . && git commit` in TanStack app (git init'd but no commits) +- Import: `npm exec nx -- import packages/ --source=. --ref=main --no-interactive` + - Next.js import auto-installed `@nx/eslint`, `@nx/next` + - React Router 7 import auto-installed `@nx/vite`, `@nx/react`, `@nx/docker` (Dockerfile present) + - TanStack import auto-installed `@nx/vitest` +- Post-import fixes: + 1. Removed stale `node_modules/`, `package-lock.json`, `.gitignore` from each package + 2. Removed Nx-rewritten scripts from `board-games-nextjs/package.json` (had `"build": "nx next:build"`, etc.) + 3. Updated root `tsconfig.base.json`: `nodenext` → `bundler`, added `dom`/`dom.iterable` to lib, added `jsx: react-jsx` + 4. Added `build` to dest root `.gitignore` (CRA and React Router 7 output there) + 5. Fixed `noEmit` → `composite + emitDeclarationOnly` in: `board-games-vite/tsconfig.app.json`, `board-games-vite/tsconfig.node.json`, `board-games-react-router/tsconfig.json`, `board-games-tanstack/tsconfig.json` + 6. Fixed `tsBuildInfoFile` paths from `./node_modules/.tmp/...` to `./dist/...` + 7. Installed root `@types/react`, `@types/react-dom`, `@types/node` +- All targets green: `build` for all 5 projects; `typecheck` for Vite/React Router/TanStack; `next:build` for Next.js diff --git a/.gemini/skills/nx-import/skill.md b/.gemini/skills/nx-import/skill.md index a5d078c2f81..b1cd381d3dd 100644 --- a/.gemini/skills/nx-import/skill.md +++ b/.gemini/skills/nx-import/skill.md @@ -3,13 +3,6 @@ name: nx-import description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. --- ---- - -name: nx-import -description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. - ---- - ## Quick Start - `nx import` brings code from a source repository or folder into the current workspace, preserving commit history. @@ -44,6 +37,25 @@ Read the nx docs if you have the tools for it. - **Always prefer the destination's existing conventions.** Source uses `libs/`but dest uses `packages/`? Import into `packages/` (`nx import packages/foo --source=libs/foo`). - If dest has no convention (empty workspace), ask the user. +### Application vs Library Detection + +Before importing, identify whether the source is an **application** or a **library**: + +- **Applications**: Deployable end products. Common indicators: + - _Frontend_: `next.config.*`, `vite.config.*` with a build entry point, framework-specific app scaffolding (CRA, Angular CLI app, etc.) + - _Backend (Node.js)_: Express/Fastify/NestJS server entrypoint, no `"exports"` field in `package.json` + - _JVM_: Maven `pom.xml` with `jar` or `war` and a `main` class; Gradle `application` plugin or `mainClass` setting + - _.NET_: `.csproj`/`.fsproj` with `Exe` or `WinExe` + - _General_: Dockerfile, a runnable entrypoint, no public API surface intended for import by other projects +- **Libraries**: Reusable packages consumed by other projects. Common indicators: `"main"`/`"exports"` in `package.json`, Maven/Gradle packaging as a library jar, .NET `Library`, named exports intended for import by other packages. + +**Destination directory rules**: + +- Applications → `apps/`. Check workspace globs (e.g. `pnpm-workspace.yaml`, `workspaces` in root `package.json`) for an existing `apps/*` entry. + - If `apps/*` is **not** present, add it before importing: update the workspace glob config and commit (or stage) the change. + - Example: `nx import apps/my-app --source=packages/my-app` +- Libraries → follow the dest's existing convention (`packages/`, `libs/`, etc.). + ## Common Issues ### pnpm Workspace Globs (Critical) @@ -218,6 +230,7 @@ Identify technologies in the source repo, then read and apply the matching refer Available references: +- `references/ESLINT.md` — ESLint projects: duplicate `lint`/`eslint:lint` targets, legacy `.eslintrc.*` linting generated files, flat config `.cjs` self-linting, `typescript-eslint` v7/v9 peer dep conflict, mixed ESLint v8+v9 in one workspace. - `references/GRADLE.md` - `references/JEST.md` — Jest testing: `@nx/jest/plugin` setup, jest.preset.js, testing deps by framework, tsconfig.spec.json, Jest vs Vitest coexistence, Babel transforms, CI atomization. - `references/NEXT.md` — Next.js projects: `@nx/next/plugin` targets, `withNx`, Next.js TS config (`noEmit`, `jsx: "preserve"`), auto-installing deps via wrong PM, non-Nx `create-next-app` imports, mixed Next.js+Vite coexistence. diff --git a/.gemini/skills/nx-workspace/skill.md b/.gemini/skills/nx-workspace/skill.md index ecd7aec061e..2b01d45353e 100644 --- a/.gemini/skills/nx-workspace/skill.md +++ b/.gemini/skills/nx-workspace/skill.md @@ -60,7 +60,6 @@ nx show project my-app --json | jq '.targets' nx show project my-app --json | jq '.targets.build' nx show project my-app --json | jq '.targets | keys' - # Check project metadata nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' ``` diff --git a/.github/agents/ci-monitor-subagent.agent.md b/.github/agents/ci-monitor-subagent.agent.md index fe9ec84e2ff..662fd261436 100644 --- a/.github/agents/ci-monitor-subagent.agent.md +++ b/.github/agents/ci-monitor-subagent.agent.md @@ -13,7 +13,7 @@ The main agent tells you which command to run: ### FETCH_STATUS Call `ci_information` with the provided branch and select fields. Return a JSON object with ONLY these fields: -`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, userAction, cipeUrl, commitSha, shortLink }` +`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, autoApplySkipped, autoApplySkipReason, userAction, cipeUrl, commitSha, shortLink }` ### FETCH_HEAVY diff --git a/.github/prompts/monitor-ci.prompt.md b/.github/prompts/monitor-ci.prompt.md index 797efed1b48..6778b5c4a8c 100644 --- a/.github/prompts/monitor-ci.prompt.md +++ b/.github/prompts/monitor-ci.prompt.md @@ -1,5 +1,5 @@ --- -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. argument-hint: "[instructions] [--max-cycles N] [--timeout MINUTES] [--verbosity minimal|medium|verbose] [--branch BRANCH] [--fresh] [--auto-fix-workflow] [--new-cipe-timeout MINUTES] [--local-verify-attempts N]" --- @@ -36,7 +36,7 @@ Parse any overrides from `${input:args}` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.github/skills/monitor-ci/SKILL.md b/.github/skills/monitor-ci/SKILL.md index fe56ccedd35..a4af6cbb556 100644 --- a/.github/skills/monitor-ci/SKILL.md +++ b/.github/skills/monitor-ci/SKILL.md @@ -1,6 +1,6 @@ --- name: monitor-ci -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. --- # Monitor CI Command @@ -36,7 +36,7 @@ Parse any overrides from `$ARGUMENTS` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.github/skills/monitor-ci/references/fix-flows.md b/.github/skills/monitor-ci/references/fix-flows.md new file mode 100644 index 00000000000..b33aa02167b --- /dev/null +++ b/.github/skills/monitor-ci/references/fix-flows.md @@ -0,0 +1,108 @@ +# Detailed Status Handling & Fix Flows + +## Status Handling by Code + +### fix_auto_apply_skipped + +The script returns `autoApplySkipReason` in its output. + +1. Report the skip reason to the user (e.g., "Auto-apply was skipped because the previous CI pipeline execution was triggered by Nx Cloud") +2. Offer to apply the fix manually — spawn UPDATE_FIX subagent with `APPLY` if user agrees +3. Record `last_cipe_url`, enter wait mode + +### fix_apply_ready + +- Spawn UPDATE_FIX subagent with `APPLY` +- Record `last_cipe_url`, enter wait mode + +### fix_needs_local_verify + +The script returns `verifiableTaskIds` in its output. + +1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` +2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task +3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode +4. **If any fail** → Apply Locally + Enhance Flow (see below) + +### fix_needs_review + +Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): + +- If fix looks correct → apply via MCP +- If fix needs enhancement → Apply Locally + Enhance Flow +- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow + +### fix_failed / no_fix + +Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. + +### environment_issue + +1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` +3. Enter wait mode with `last_cipe_url` set + +### self_healing_throttled + +Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. + +1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) +2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` +3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. +4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode + +### no_new_cipe + +1. Report to user: no CI attempt found, suggest checking CI provider +2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode +3. Otherwise: exit with guidance + +### cipe_no_tasks + +1. Report to user: CI failed with no tasks recorded +2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode +3. If retry also returns `cipe_no_tasks`: exit with failure + +## Fix Action Flows + +### Apply via MCP + +Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. + +### Apply Locally + Enhance Flow + +1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) +2. Enhance code to fix failing tasks +3. Run failing tasks to verify +4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. +5. If passing → commit and push, enter wait mode + +### Reject + Fix From Scratch Flow + +1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `REJECT` +3. Fix from scratch locally +4. Commit and push, enter wait mode + +## Environment vs Code Failure Recognition + +When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. + +**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. + +When detected → bail immediately without running gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. + +**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. + +## Git Safety + +- Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets + +## Commit Message Format + +```bash +git commit -m "fix(): + +Failed tasks: , +Local verification: passed|enhanced|failed-pushing-to-ci" +``` diff --git a/.github/skills/monitor-ci/scripts/ci-poll-decide.mjs b/.github/skills/monitor-ci/scripts/ci-poll-decide.mjs index d14b54df090..5a296493320 100644 --- a/.github/skills/monitor-ci/scripts/ci-poll-decide.mjs +++ b/.github/skills/monitor-ci/scripts/ci-poll-decide.mjs @@ -76,6 +76,8 @@ const { failedTaskIds = [], verifiedTaskIds = [], couldAutoApplyTasks, + autoApplySkipped, + autoApplySkipReason, userAction, cipeUrl, commitSha, @@ -154,14 +156,15 @@ function isNewCipe() { // 13. self-healing in progress → poll (sh_running) // 14. flaky task auto-rerun → poll (flaky_rerun) // 15. fix auto-applied → poll (fix_auto_applied) -// 16. auto-apply: verification pending→ poll (verification_pending) -// 17. auto-apply: verified → done (fix_auto_applying) -// 18. fix: verification failed/none → done (fix_needs_review) -// 19. fix: all/e2e verified → done (fix_apply_ready) -// 20. fix: needs local verify → done (fix_needs_local_verify) -// 21. self-healing failed → done (fix_failed) -// 22. no fix available → done (no_fix) -// 23. fallback → poll (fallback) +// 16. auto-apply: skipped → done (fix_auto_apply_skipped) +// 17. auto-apply: verification pending→ poll (verification_pending) +// 18. auto-apply: verified → done (fix_auto_applying) +// 19. fix: verification failed/none → done (fix_needs_review) +// 20. fix: all/e2e verified → done (fix_apply_ready) +// 21. fix: needs local verify → done (fix_needs_local_verify) +// 22. self-healing failed → done (fix_failed) +// 23. no fix available → done (no_fix) +// 24. fallback → poll (fallback) // ============================================================ function classify() { @@ -209,6 +212,12 @@ function classify() { // --- Auto-apply path (couldAutoApplyTasks) --- if (couldAutoApplyTasks === true) { + if (autoApplySkipped === true) + return { + action: "done", + code: "fix_auto_apply_skipped", + extra: { autoApplySkipReason }, + }; if (verificationStatus === "NOT_STARTED" || verificationStatus === "IN_PROGRESS") return { action: "poll", code: "verification_pending" }; if (verificationStatus === "COMPLETED") return { action: "done", code: "fix_auto_applying" }; @@ -282,6 +291,10 @@ const messages = { // actionable fix_auto_applying: () => "Fix verified! Auto-applying...", + fix_auto_apply_skipped: (extra) => + `Fix verified but auto-apply was skipped. ${ + extra?.autoApplySkipReason ? `Reason: ${extra.autoApplySkipReason}` : "Offer to apply manually." + }`, fix_needs_review: () => `Fix available but needs review. Verification: ${verificationStatus || "N/A"}`, fix_apply_ready: () => "Fix available and verified. Ready to apply.", fix_needs_local_verify: (extra) => @@ -300,6 +313,7 @@ const messages = { const resetProgressCodes = new Set([ "ci_success", "fix_auto_applying", + "fix_auto_apply_skipped", "fix_needs_review", "fix_apply_ready", "fix_needs_local_verify", @@ -351,6 +365,7 @@ function buildOutput(decision) { // Add extras if (code === "new_cipe_detected") result.newCipeDetected = true; if (extra?.verifiableTaskIds) result.verifiableTaskIds = extra.verifiableTaskIds; + if (extra?.autoApplySkipReason) result.autoApplySkipReason = extra.autoApplySkipReason; console.log(JSON.stringify(result)); } diff --git a/.github/skills/nx-import/SKILL.md b/.github/skills/nx-import/SKILL.md index a5d078c2f81..b1cd381d3dd 100644 --- a/.github/skills/nx-import/SKILL.md +++ b/.github/skills/nx-import/SKILL.md @@ -3,13 +3,6 @@ name: nx-import description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. --- ---- - -name: nx-import -description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. - ---- - ## Quick Start - `nx import` brings code from a source repository or folder into the current workspace, preserving commit history. @@ -44,6 +37,25 @@ Read the nx docs if you have the tools for it. - **Always prefer the destination's existing conventions.** Source uses `libs/`but dest uses `packages/`? Import into `packages/` (`nx import packages/foo --source=libs/foo`). - If dest has no convention (empty workspace), ask the user. +### Application vs Library Detection + +Before importing, identify whether the source is an **application** or a **library**: + +- **Applications**: Deployable end products. Common indicators: + - _Frontend_: `next.config.*`, `vite.config.*` with a build entry point, framework-specific app scaffolding (CRA, Angular CLI app, etc.) + - _Backend (Node.js)_: Express/Fastify/NestJS server entrypoint, no `"exports"` field in `package.json` + - _JVM_: Maven `pom.xml` with `jar` or `war` and a `main` class; Gradle `application` plugin or `mainClass` setting + - _.NET_: `.csproj`/`.fsproj` with `Exe` or `WinExe` + - _General_: Dockerfile, a runnable entrypoint, no public API surface intended for import by other projects +- **Libraries**: Reusable packages consumed by other projects. Common indicators: `"main"`/`"exports"` in `package.json`, Maven/Gradle packaging as a library jar, .NET `Library`, named exports intended for import by other packages. + +**Destination directory rules**: + +- Applications → `apps/`. Check workspace globs (e.g. `pnpm-workspace.yaml`, `workspaces` in root `package.json`) for an existing `apps/*` entry. + - If `apps/*` is **not** present, add it before importing: update the workspace glob config and commit (or stage) the change. + - Example: `nx import apps/my-app --source=packages/my-app` +- Libraries → follow the dest's existing convention (`packages/`, `libs/`, etc.). + ## Common Issues ### pnpm Workspace Globs (Critical) @@ -218,6 +230,7 @@ Identify technologies in the source repo, then read and apply the matching refer Available references: +- `references/ESLINT.md` — ESLint projects: duplicate `lint`/`eslint:lint` targets, legacy `.eslintrc.*` linting generated files, flat config `.cjs` self-linting, `typescript-eslint` v7/v9 peer dep conflict, mixed ESLint v8+v9 in one workspace. - `references/GRADLE.md` - `references/JEST.md` — Jest testing: `@nx/jest/plugin` setup, jest.preset.js, testing deps by framework, tsconfig.spec.json, Jest vs Vitest coexistence, Babel transforms, CI atomization. - `references/NEXT.md` — Next.js projects: `@nx/next/plugin` targets, `withNx`, Next.js TS config (`noEmit`, `jsx: "preserve"`), auto-installing deps via wrong PM, non-Nx `create-next-app` imports, mixed Next.js+Vite coexistence. diff --git a/.github/skills/nx-import/references/ESLINT.md b/.github/skills/nx-import/references/ESLINT.md new file mode 100644 index 00000000000..0d4afb8d9d0 --- /dev/null +++ b/.github/skills/nx-import/references/ESLINT.md @@ -0,0 +1,109 @@ +## ESLint + +ESLint-specific guidance for `nx import`. For generic import issues (root deps, pnpm globs, project references), see `SKILL.md`. + +--- + +### How `@nx/eslint/plugin` Works + +`@nx/eslint/plugin` scans for ESLint config files and creates a lint target for each project. It detects **both** flat config files (`eslint.config.{js,mjs,cjs,ts,mts,cts}`) and legacy config files (`.eslintrc.{json,js,cjs,mjs,yml,yaml}`). + +**Plugin options (set during `nx add @nx/eslint`):** + +```json +{ + "plugin": "@nx/eslint/plugin", + "options": { + "targetName": "eslint:lint" + } +} +``` + +**Auto-installation**: `nx import` auto-detects ESLint config files and offers to install `@nx/eslint`. Accept the offer — it registers the plugin and updates `namedInputs.production` to exclude ESLint config files. + +--- + +### Duplicate `lint` and `eslint:lint` Targets + +After import, projects will have **two** lint-related targets if the source `package.json` has a `"lint"` npm script: + +- `eslint:lint` — inferred by `@nx/eslint/plugin`; has proper caching and input/output tracking +- `lint` — created by Nx from the npm script via `nx:run-script`; no caching intelligence, just wraps `npm run lint` + +**Fix**: Remove the `"lint"` script from each project's `package.json`. Keep `"lint:fix"` if present — there is no plugin-inferred equivalent for auto-fixing. + +--- + +### Legacy `.eslintrc.*` Configs Linting Generated Files + +When `@nx/eslint/plugin` runs `eslint .` on a project with a legacy `.eslintrc.*` config that uses `parserOptions.project`, it tries to lint **all** files in the project directory including: + +- Generated `dist/**/*.d.ts` files (not in tsconfig `include`) +- The `.eslintrc.js` config file itself (not in tsconfig `include`) + +This causes `Parsing error: ESLint was configured to run on X using parserOptions.project, however that TSConfig does not include this file`. + +**Fix**: Add `ignorePatterns` to the `.eslintrc.*` config: + +```json +// .eslintrc.json +{ + "ignorePatterns": ["dist/**"] +} +``` + +```js +// .eslintrc.js — also ignore the config file itself since module.exports isn't in tsconfig +module.exports = { + ignorePatterns: ["dist/**", ".eslintrc.js"], + // ... +}; +``` + +--- + +### Flat Config `.cjs` Files Self-Linting + +When a project uses `eslint.config.cjs` (CJS flat config), `eslint .` lints the config file itself. The `require()` call on line 1 triggers `@typescript-eslint/no-require-imports`. + +**Fix**: Add the config filename to the top-level `ignores` array: + +```js +module.exports = tseslint.config( + { + ignores: ["dist/**", "node_modules/**", "eslint.config.cjs"], + }, + // ... +); +``` + +The same applies to `eslint.config.js` in a CJS project (no `"type": "module"`) if it uses `require()`. + +--- + +### `typescript-eslint` Version Conflict With ESLint 9 + +`typescript-eslint@7.x` declares `peerDependencies: { "eslint": "^8.56.0" }`, but it is commonly used alongside `"eslint": "^9.0.0"`. npm treats this as a hard peer dep conflict and refuses to install. + +**Root cause**: `@nx/eslint` init adds `eslint@~8.57.0` at the workspace root (for its own peer deps). Workspace packages that request `eslint@^9.0.0` + `typescript-eslint@^7.0.0` trigger the conflict when npm resolves their deps. + +**Fix**: Upgrade `typescript-eslint` from `^7.0.0` to `^8.0.0` directly in the affected workspace package's `package.json`. The `tseslint.config()` API and `tseslint.configs.recommended` are identical between v7 and v8 — no config changes needed. + +```json +// packages/my-package/package.json +{ + "devDependencies": { + "typescript-eslint": "^8.0.0" + } +} +``` + +**Note**: npm's root-level `"overrides"` field does not force versions for workspace packages' direct dependencies — update each package.json individually. + +--- + +### Mixed ESLint v8 and v9 in One Workspace + +Legacy v8 and flat-config v9 packages can coexist in the same workspace. Each package resolves its own `eslint` version. The root `eslint@~8.57.0` (added by `@nx/eslint` init) is used by legacy v8 packages; v9 packages get their own hoisted `eslint@9`. + +`@nx/eslint/plugin` infers `eslint:lint` targets for **both** config formats. Legacy packages run ESLint v8 with `.eslintrc.*`; flat-config packages run ESLint v9 with `eslint.config.*`. No special nx.json configuration is needed to support both simultaneously. diff --git a/.github/skills/nx-import/references/NEXT.md b/.github/skills/nx-import/references/NEXT.md index 12466d6ba5f..d9ec1f0b557 100644 --- a/.github/skills/nx-import/references/NEXT.md +++ b/.github/skills/nx-import/references/NEXT.md @@ -54,6 +54,20 @@ Next.js app tsconfigs have unique patterns compared to Vite: Imported Next.js configs may have `// eslint-disable-next-line @typescript-eslint/no-var-requires` but the project ESLint config enables different rule sets. This produces `Unused eslint-disable directive` warnings. Harmless — remove the comment or ignore. +### `@nx/next:init` Rewrites All npm Scripts (Whole-Repo Import) + +When `@nx/next:init` runs during a whole-repo import, it rewrites the project's `package.json` scripts to prefixed `nx` calls: + +```json +{ + "dev": "nx next:dev", + "build": "nx next:build", + "start": "nx next:start" +} +``` + +This is the standard "npm Script Rewriting" issue from SKILL.md, but triggered by `@nx/next:init` rather than Nx init. **Fix**: Remove all rewritten scripts from `package.json` — `@nx/next/plugin` infers all targets from `next.config.*`. + --- ## Non-Nx Source (create-next-app) @@ -66,6 +80,10 @@ For single-project `create-next-app` repos, use whole-repo import into a subdire nx import /path/to/source apps/web --ref=main --source=. --no-interactive ``` +### `next-env.d.ts` + +`next build` auto-generates `next-env.d.ts` at the project root. Add `next-env.d.ts` to the dest root `.gitignore` — it is framework-generated and should not be committed. + ### ESLint: Self-Contained `eslint-config-next` `create-next-app` generates a flat ESLint config using `eslint-config-next` (which bundles its own plugins). This is **self-contained** — no root `eslint.config.mjs` needed, no `@nx/eslint-plugin` dependency. The `@nx/eslint/plugin` detects it and creates a lint target. @@ -123,17 +141,19 @@ No naming conflicts between frameworks. ## Fix Order — Nx Source (Subdirectory Import) -1. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) -2. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` -3. ESLint setup (see SKILL.md: "Root ESLint Config Missing") -4. Jest setup (see SKILL.md: "Jest Preset Missing") -5. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` +1. Import Next.js apps into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) +3. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` +4. ESLint setup (see SKILL.md: "Root ESLint Config Missing") +5. Jest setup (see SKILL.md: "Jest Preset Missing") +6. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` ## Fix Order — Non-Nx Source (create-next-app) -1. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) -2. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) -3. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) +1. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) +3. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) +4. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) --- @@ -168,6 +188,16 @@ No naming conflicts between frameworks. - No test setup (create-next-app doesn't include tests) - All targets green: next:build, eslint:lint +### Scenario 4: Non-Nx create-next-app (alongside Vite, React Router 7, TanStack, CRA) → TS preset (PASS) + +- See VITE.md Scenario 6 for the full multi-import scenario +- Next.js-specific findings: + 1. `@nx/next:init` rewrote all scripts to `nx next:*` format — removed all rewritten scripts + 2. Stale files: `node_modules/`, `package-lock.json`, `.gitignore` — deleted (npm workspace, no pnpm files) + 3. ESLint self-contained via `eslint-config-next` — no root config needed + 4. No tsconfig changes needed — `noEmit: true` stays; `next build` handles type checking +- Targets: `next:build`, `next:dev`, `next:start`, `eslint:lint` + ### Scenario 5: Mixed Next.js (Nx) + Vite React (standalone) → TS preset (PASS) - Source A: CNW next preset (Next.js 16, App Router) — subdirectory import of `apps/` diff --git a/.github/skills/nx-import/references/VITE.md b/.github/skills/nx-import/references/VITE.md index 58ea909c6eb..5b3817eba42 100644 --- a/.github/skills/nx-import/references/VITE.md +++ b/.github/skills/nx-import/references/VITE.md @@ -43,6 +43,71 @@ See SKILL.md for the generic noEmit→composite fix. Vite-specific additions: --- +## React Router 7 (Vite-Based) + +React Router 7 (`@react-router/dev`) uses Vite under the hood with a `vite.config.ts` and a `react-router.config.ts`. The `@nx/vite/plugin` detects `vite.config.ts` and creates inferred targets. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `serve` targets. The `build` target invokes the script defined in `package.json` (usually `react-router build`), not `vite build` directly. + +**No separate typecheck target from `@nx/vite/plugin`** — React Router 7 typegen is run as part of `typecheck` (e.g. `react-router typegen && tsc`). The `typecheck` target is inferred from the tsconfig. Keep the `typecheck` script in `package.json` if present; it is not rewritten. + +### tsconfig Notes + +React Router 7 uses a single `tsconfig.json` (no `tsconfig.app.json`/`tsconfig.node.json` split). It includes: + +- `"rootDirs": [".", "./.react-router/types"]` — for generated type files; keep as-is +- `"paths": { "~/*": ["./app/*"] }` — self-referential alias; keep as-is +- `"noEmit": true` — replace with composite settings per SKILL.md + +### Build Output + +React Router 7 outputs to `build/` (not `dist/`). Add `build` to the dest root `.gitignore`. + +### Generated Types Directory + +React Router 7 generates `.react-router/` at the project root for route type generation. Add `.react-router` to the dest root `.gitignore`. + +--- + +## TanStack Start (Vite-Based) + +TanStack Start uses Vinxi under the hood, which wraps Vite. Projects have a standard `vite.config.ts` that `@nx/vite/plugin` detects normally. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `preview`, `serve-static`, `typecheck` targets. The `build` target runs `vite build` which invokes the TanStack Start Vinxi pipeline (produces both client and SSR bundles). + +### tsconfig Notes + +TanStack Start uses a single `tsconfig.json` with `"allowImportingTsExtensions": true` and `"noEmit": true`. Apply the standard noEmit → composite fix. `allowImportingTsExtensions` is compatible with `emitDeclarationOnly: true` — no change needed. + +### `paths` Aliases + +TanStack Start commonly uses `"#/*": ["./src/*"]` and `"@/*": ["./src/*"]`. These are self-referential — keep as-is for a single-project app. + +### Uncommitted Source Repo + +`create-tan-stack` initializes a git repo but does NOT make an initial commit. Before importing, commit first: + +```bash +git -C /path/to/source add . && git -C /path/to/source commit -m "Initial commit" +``` + +### Generated and Build Directories + +TanStack Start / Vinxi / Nitro generate several directories that must be added to the dest root `.gitignore`: + +- `.vinxi` — Vinxi build cache +- `.tanstack` — TanStack generated files +- `.nitro` — Nitro build artifacts +- `.output` — server-side build output (SSR/edge) + +These are not covered by `dist` or `build`. + +--- + ## React-Specific ### React Dependencies @@ -195,6 +260,42 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t --- +## Redundant npm Scripts After Import + +`nx import` copies `package.json` verbatim, so npm scripts come along. For Vite-based projects `@nx/vite/plugin` already infers the same targets from `vite.config.ts` — the npm scripts just shadow the plugin with weaker `nx:run-script` wrappers (no first-class caching inputs/outputs). Remove them after import. + +### Standalone Vite App (`create-vite`) + +Remove the following scripts — every one is redundant: + +| Script | Plugin replacement | +| ----------------------------- | ---------------------------------------------------------------------------- | +| `dev: vite` | `@nx/vite/plugin` → `dev` | +| `build: tsc -b && vite build` | `@nx/vite/plugin` → `build`; `typecheck` via `@nx/js/typescript` handles tsc | +| `preview: vite preview` | `@nx/vite/plugin` → `preview` | +| `lint: eslint .` | `@nx/eslint/plugin` → `eslint:lint` | + +### TanStack Start + +Remove `build`, `dev`, `preview`, and `test` scripts, but move any hardcoded `--port` flag to `vite.config.ts` first: + +```ts +// vite.config.ts +export default defineConfig({ + server: { port: 3000 }, // replaces `vite dev --port 3000` + ... +}) +``` + +### React Router 7 — Keep ALL scripts + +Do **not** remove React Router 7 scripts. They use the framework CLI (`react-router build`, `react-router dev`, `react-router-serve`) which is not interchangeable with plain `vite`: + +- `typecheck` runs `react-router typegen && tsc` — typegen must precede `tsc` or it fails on missing route types +- `start` serves the SSR bundle — no plugin equivalent + +--- + ## Fix Orders ### Nx Source @@ -208,19 +309,43 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t ### Non-Nx Source (additional steps) +0. Import into `apps/` (see SKILL.md: "Application vs Library Detection") 1. Generic fixes from SKILL.md (stale files cleanup, pnpm globs, rewritten scripts, target name prefixing, noEmit→composite, ESLint handling) 2. Fix `noEmit` in **all** tsconfigs (app, node, etc. — non-Nx projects often have multiple) 3. Add `extends` to solution-style tsconfigs so root settings apply 4. Fix `resolve.alias` / `__dirname` / `baseUrl` 5. Ensure `types` include `vite/client` and `node` 6. Install `@nx/vite` manually if it failed during import -7. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores -8. Full verification +7. Remove redundant npm scripts so `@nx/vite/plugin` infers them natively (see "Redundant npm Scripts" section) +8. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores +9. Full verification ### Multiple-Source Imports See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific: fix tsconfig `references` paths for alternate directories (`../../libs/` → `../../libs-beta/`). +### Non-Nx Source: React Router 7 + +1. Ensure source has at least one commit (see SKILL.md: "Source Repo Has No Commits") +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/react` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Add `build` and `.react-router` to dest root `.gitignore` +6. **Keep all npm scripts** — React Router 7 uses framework CLI (`react-router build/dev`), not plain vite (see "Redundant npm Scripts" above) +7. `npm install && nx reset && nx sync --yes` + +### Non-Nx Source: TanStack Start + +1. Ensure source has at least one commit — `create-tan-stack` does NOT auto-commit (see SKILL.md) +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/vitest` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Keep `allowImportingTsExtensions` — compatible with `emitDeclarationOnly: true` +6. Add `.vinxi`, `.tanstack`, `.nitro`, `.output` to dest root `.gitignore` +7. Move hardcoded `--port` from `dev` script into `vite.config.ts` (`server: { port: N }`) +8. Remove redundant npm scripts — `@nx/vite/plugin` infers `build`, `dev`, `preview`, `test` (see "Redundant npm Scripts" above) +9. `npm install && nx reset && nx sync --yes` + ### Quick Reference: React vs Vue | Aspect | React | Vue | @@ -232,3 +357,41 @@ See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific | ESLint parser | Standard TS | `vue-eslint-parser` + TS sub-parser | | ESLint setup | Straightforward | Must install deps before `@nx/eslint` | | Test utils | `@testing-library/react` | `@vue/test-utils` | + +### Quick Reference: Vite-Based React Frameworks + +| Aspect | Vite (standalone) | React Router 7 | TanStack Start | +| ------------------ | ----------------- | ----------------------- | ------------------------ | +| Build config | `vite.config.ts` | `vite.config.ts` | `vite.config.ts` | +| Build output | `dist/` | `build/` | `dist/` | +| SSR bundle | No | Yes (`build/server/`) | Yes (`dist/server/`) | +| tsconfig layout | app + node split | Single tsconfig | Single tsconfig | +| Auto-committed | Depends on tool | Usually yes | **No — commit first** | +| `nx import` plugin | `@nx/vite` | `@nx/vite`, `@nx/react` | `@nx/vite`, `@nx/vitest` | + +--- + +## Iteration Log + +### Scenario 6: Multiple non-Nx React apps (CRA, Next.js, React Router 7, TanStack Start, Vite) → TS preset (PASS) + +- Sources: 5 standalone non-Nx repos with different build tools +- Dest: CNW ts preset (Nx 22.5.1), npm workspaces, `packages/*` +- Import: whole-repo for each, sequential into `packages/` +- Pre-import fixes: + 1. Removed `packages/.gitkeep` and committed + 2. `git init && git add . && git commit` in Vite app (no git at all) + 3. `git add . && git commit` in TanStack app (git init'd but no commits) +- Import: `npm exec nx -- import packages/ --source=. --ref=main --no-interactive` + - Next.js import auto-installed `@nx/eslint`, `@nx/next` + - React Router 7 import auto-installed `@nx/vite`, `@nx/react`, `@nx/docker` (Dockerfile present) + - TanStack import auto-installed `@nx/vitest` +- Post-import fixes: + 1. Removed stale `node_modules/`, `package-lock.json`, `.gitignore` from each package + 2. Removed Nx-rewritten scripts from `board-games-nextjs/package.json` (had `"build": "nx next:build"`, etc.) + 3. Updated root `tsconfig.base.json`: `nodenext` → `bundler`, added `dom`/`dom.iterable` to lib, added `jsx: react-jsx` + 4. Added `build` to dest root `.gitignore` (CRA and React Router 7 output there) + 5. Fixed `noEmit` → `composite + emitDeclarationOnly` in: `board-games-vite/tsconfig.app.json`, `board-games-vite/tsconfig.node.json`, `board-games-react-router/tsconfig.json`, `board-games-tanstack/tsconfig.json` + 6. Fixed `tsBuildInfoFile` paths from `./node_modules/.tmp/...` to `./dist/...` + 7. Installed root `@types/react`, `@types/react-dom`, `@types/node` +- All targets green: `build` for all 5 projects; `typecheck` for Vite/React Router/TanStack; `next:build` for Next.js diff --git a/.github/skills/nx-workspace/SKILL.md b/.github/skills/nx-workspace/SKILL.md index ecd7aec061e..2b01d45353e 100644 --- a/.github/skills/nx-workspace/SKILL.md +++ b/.github/skills/nx-workspace/SKILL.md @@ -60,7 +60,6 @@ nx show project my-app --json | jq '.targets' nx show project my-app --json | jq '.targets.build' nx show project my-app --json | jq '.targets | keys' - # Check project metadata nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' ``` diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 589447bb4d4..40acdf8fcf6 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -22,7 +22,7 @@ jobs: - uses: actions/setup-node@v6 with: node-version: '24' - - uses: pnpm/action-setup@v4.2.0 + - uses: pnpm/action-setup@v5.0.0 name: Install pnpm id: pnpm-install with: diff --git a/.github/workflows/nodejs.yml b/.github/workflows/nodejs.yml index 5e8c47ccb05..fb064110ebb 100644 --- a/.github/workflows/nodejs.yml +++ b/.github/workflows/nodejs.yml @@ -11,7 +11,6 @@ concurrency: env: NX_VERBOSE_LOGGING: true - # NX_CLOUD_DISTRIBUTED_EXECUTION will be set dynamically after dependencies are installed. NX_CLOUD_ACCESS_TOKEN: "${{ secrets.NX_CLOUD_ACCESS_TOKEN }}" firebaseToken: "${{ secrets.FIREBASE_SERVICE_ACCOUNT_TSPARTICLES }}" @@ -32,7 +31,7 @@ jobs: with: node-version: "24" - - uses: pnpm/action-setup@v4.4.0 + - uses: pnpm/action-setup@v5.0.0 with: run_install: false @@ -52,38 +51,38 @@ jobs: - name: Install dependencies run: pnpm install - - name: Enable Nx Cloud distributed execution - if: ${{ env.NX_CLOUD_ACCESS_TOKEN != '' }} + - name: Initialize Nx Cloud or fall back to local run: | - echo "NX Cloud token present — enabling distributed execution" - echo "NX_CLOUD_DISTRIBUTED_EXECUTION=true" >> $GITHUB_ENV - - - name: Disable Nx Cloud distributed execution - if: ${{ env.NX_CLOUD_ACCESS_TOKEN == '' }} - run: | - echo "NX Cloud token missing — using local nx execution" - echo "NX_CLOUD_DISTRIBUTED_EXECUTION=false" >> $GITHUB_ENV + if [ -z "$NX_CLOUD_ACCESS_TOKEN" ]; then + echo "NX Cloud token missing — using local nx execution" + echo "NX_CLOUD_DISTRIBUTED_EXECUTION=false" >> $GITHUB_ENV + exit 0 + fi - - name: Initialize Nx Cloud (optional) - if: ${{ env.NX_CLOUD_ACCESS_TOKEN != '' }} - continue-on-error: true - run: | - echo "Attempting to start nx-cloud (non-fatal)..." - # Show nx-cloud version for debugging (non-sensitive) + echo "NX Cloud token present — attempting distributed execution" npx nx-cloud --version || echo "nx-cloud --version not available" - # Retry start up to 3 times with exponential backoff to handle transient GitHub API errors. retries=0 max_retries=3 + nx_cloud_started=false + until [ "$retries" -ge "$max_retries" ]; do - npx nx-cloud start-ci-run --distribute-on="5 linux-medium-js" && break - echo "nx-cloud start failed (attempt ${retries}). Retrying in $((2 ** retries))s..." + if npx nx-cloud start-ci-run --distribute-on="5 linux-medium-js"; then + nx_cloud_started=true + break + fi + echo "nx-cloud start failed (attempt $((retries + 1))/${max_retries}). Retrying in $((2 ** retries))s..." sleep $((2 ** retries)) retries=$((retries + 1)) done - if [ "$retries" -ge "$max_retries" ]; then - echo "nx-cloud start failed after ${max_retries} attempts; continuing with local nx" + if [ "$nx_cloud_started" = true ]; then + echo "NX_CLOUD_DISTRIBUTED_EXECUTION=true" >> $GITHUB_ENV + echo "NX_CLOUD_STARTED=true" >> $GITHUB_ENV + else + echo "nx-cloud start failed after ${max_retries} attempts — falling back to local nx" + echo "NX_CLOUD_DISTRIBUTED_EXECUTION=false" >> $GITHUB_ENV + echo "NX_CLOUD_STARTED=false" >> $GITHUB_ENV fi - name: Prettify README @@ -95,7 +94,8 @@ jobs: - name: Run unit tests (test:ci) run: pnpm --filter @tsparticles/tests run test:ci - - if: env.firebaseToken != '' && github.ref == 'refs/heads/main' && github.event_name == 'push' + - name: Deploy to Firebase (production) + if: env.firebaseToken != '' && github.ref == 'refs/heads/main' && github.event_name == 'push' uses: FirebaseExtended/action-hosting-deploy@v0 with: repoToken: "${{ secrets.GITHUB_TOKEN }}" @@ -103,16 +103,15 @@ jobs: projectId: tsparticles channelId: live - - if: env.firebaseToken != '' && github.event_name == 'pull_request' && github.actor == 'matteobruni' + - name: Deploy to Firebase (PR preview) + if: env.firebaseToken != '' && github.event_name == 'pull_request' && github.actor == 'matteobruni' uses: FirebaseExtended/action-hosting-deploy@v0 with: repoToken: "${{ secrets.GITHUB_TOKEN }}" firebaseServiceAccount: "${{ secrets.FIREBASE_SERVICE_ACCOUNT_TSPARTICLES }}" projectId: tsparticles - - name: Stop Nx Cloud Session (optional) - if: ${{ always() && env.NX_CLOUD_ACCESS_TOKEN != '' }} + - name: Stop Nx Cloud session + if: always() && env.NX_CLOUD_STARTED == 'true' continue-on-error: true - run: | - # Best-effort stop of nx cloud session; do not fail the job if command isn't available. - npx nx fix-ci || echo "nx fix-ci failed or nx-cloud not present" + run: npx nx-cloud stop-all-agents || echo "nx-cloud stop failed — ignoring" \ No newline at end of file diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml index c4d27f5afe5..fa03838590f 100644 --- a/.github/workflows/npm-publish.yml +++ b/.github/workflows/npm-publish.yml @@ -33,7 +33,7 @@ jobs: node-version: '24' registry-url: https://registry.npmjs.org - - uses: pnpm/action-setup@v4.4.0 + - uses: pnpm/action-setup@v5.0.0 name: Install pnpm with: run_install: false diff --git a/.gitignore b/.gitignore index 1db80e1727a..d39ff16e54e 100644 --- a/.gitignore +++ b/.gitignore @@ -385,4 +385,6 @@ docs.json .nx/cache .nx/workspace-data -.nx/polygraph \ No newline at end of file +.nx/polygraph +.claude/worktrees +.claude/settings.local.json \ No newline at end of file diff --git a/.opencode/agents/ci-monitor-subagent.md b/.opencode/agents/ci-monitor-subagent.md index b55b04a279d..98003c6a773 100644 --- a/.opencode/agents/ci-monitor-subagent.md +++ b/.opencode/agents/ci-monitor-subagent.md @@ -14,7 +14,7 @@ The main agent tells you which command to run: ### FETCH_STATUS Call `ci_information` with the provided branch and select fields. Return a JSON object with ONLY these fields: -`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, userAction, cipeUrl, commitSha, shortLink }` +`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, autoApplySkipped, autoApplySkipReason, userAction, cipeUrl, commitSha, shortLink }` ### FETCH_HEAVY diff --git a/.opencode/commands/monitor-ci.md b/.opencode/commands/monitor-ci.md index 748184edcc4..2a9d8719d63 100644 --- a/.opencode/commands/monitor-ci.md +++ b/.opencode/commands/monitor-ci.md @@ -1,5 +1,5 @@ --- -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. argument-hint: "[instructions] [--max-cycles N] [--timeout MINUTES] [--verbosity minimal|medium|verbose] [--branch BRANCH] [--fresh] [--auto-fix-workflow] [--new-cipe-timeout MINUTES] [--local-verify-attempts N]" --- @@ -36,7 +36,7 @@ Parse any overrides from `$ARGUMENTS` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.opencode/skills/monitor-ci/SKILL.md b/.opencode/skills/monitor-ci/SKILL.md index fe56ccedd35..a4af6cbb556 100644 --- a/.opencode/skills/monitor-ci/SKILL.md +++ b/.opencode/skills/monitor-ci/SKILL.md @@ -1,6 +1,6 @@ --- name: monitor-ci -description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. ALWAYS USE THIS SKILL instead of native CI provider tools (gh, glab, etc.) for CI monitoring. +description: Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, glab, etc.) for CI monitoring — it integrates with Nx Cloud self-healing which those tools cannot access. --- # Monitor CI Command @@ -36,7 +36,7 @@ Parse any overrides from `$ARGUMENTS` and merge with defaults. ## Nx Cloud Connection Check -**CRITICAL**: Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. +Before starting the monitoring loop, verify the workspace is connected to Nx Cloud. Without this connection, no CI data is available and the entire skill is inoperable. ### Step 0: Verify Nx Cloud Connection @@ -63,9 +63,9 @@ The decision script handles message formatting based on verbosity. When printing - Prepend `[monitor-ci]` to every message from the script's `message` field - For your own action messages (e.g. "Applying fix via MCP..."), also prepend `[monitor-ci]` -## Anti-Patterns (NEVER DO) +## Anti-Patterns -**CRITICAL**: The following behaviors are strictly prohibited: +These behaviors cause real problems — racing with self-healing, losing CI progress, or wasting context: | Anti-Pattern | Why It's Bad | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | @@ -77,53 +77,27 @@ The decision script handles message formatting based on verbosity. When printing **If this skill fails to activate**, the fallback is: -1. Use CI provider CLI for READ-ONLY status check (single call, no watch/polling flags) +1. Use CI provider CLI for a one-time, read-only status check (single call, no watch/polling flags) 2. Immediately delegate to this skill with gathered context -3. NEVER continue polling on main agent - -**CI provider CLIs are acceptable ONLY for:** - -- One-time read of PR/pipeline status -- Getting PR/branch metadata -- NOT for continuous monitoring or watch mode +3. Do not continue polling on main agent — it wastes context tokens and bypasses self-healing ## Session Context Behavior -**Important:** Within a Claude Code session, conversation context persists. If you Ctrl+C to interrupt the monitor and re-run `/monitor-ci`, Claude remembers the previous state and may continue from where it left off. - -- **To continue monitoring:** Just re-run `/monitor-ci` (context is preserved) -- **To start fresh:** Use `/monitor-ci --fresh` to ignore previous context -- **For a completely clean slate:** Exit Claude Code and restart `claude` +If the user previously ran `/monitor-ci` in this session, you may have prior state (poll counts, last CI Attempt URL, etc.). Resume from that state unless `--fresh` is set, in which case discard it and start from Step 1. ## MCP Tool Reference -### `ci_information` - -**Input:** - -```json -{ - "branch": "string (optional, defaults to current git branch)", - "select": "string (optional, comma-separated field names)", - "pageToken": "number (optional, 0-based pagination for long strings)" -} -``` - -**Field Sets for Efficient Polling:** +Three field sets control polling efficiency — use the lightest set that gives you what you need: ```yaml -WAIT_FIELDS: - "cipeUrl,commitSha,cipeStatus" - # Minimal fields for detecting new CI Attempt +WAIT_FIELDS: "cipeUrl,commitSha,cipeStatus" +LIGHT_FIELDS: "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,autoApplySkipped,autoApplySkipReason,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" +HEAVY_FIELDS: "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" +``` -LIGHT_FIELDS: - "cipeStatus,cipeUrl,branch,commitSha,selfHealingStatus,verificationStatus,userAction,failedTaskIds,verifiedTaskIds,selfHealingEnabled,failureClassification,couldAutoApplyTasks,shortLink,confidence,confidenceReasoning,hints,selfHealingSkippedReason,selfHealingSkipMessage" - # Status fields for determining actionable state +The `ci_information` tool accepts `branch` (optional, defaults to current git branch), `select` (comma-separated field names), and `pageToken` (0-based pagination for long strings). -HEAVY_FIELDS: - "taskOutputSummary,suggestedFix,suggestedFixReasoning,suggestedFixDescription" - # Large content fields - fetch only when needed for fix decisions -``` +The `update_self_healing_fix` tool accepts a `shortLink` and an action: `APPLY`, `REJECT`, or `RERUN_ENVIRONMENT_STATE`. ## Default Behaviors by Status @@ -131,128 +105,37 @@ The decision script returns one of the following statuses. This table defines th **Simple exits** — just report and exit: -| Status | Default Behavior | -| ----------------------- | ----------------------------------------------------------------------------------------------------- | -| `ci_success` | Exit with success | -| `cipe_canceled` | Exit, CI was canceled | -| `cipe_timed_out` | Exit, CI timed out | -| `polling_timeout` | Exit, polling timeout reached | -| `circuit_breaker` | Exit, no progress after 5 consecutive polls | -| `environment_rerun_cap` | Exit, environment reruns exhausted | -| `fix_auto_applying` | Do NOT call MCP — self-healing handles it. Record `last_cipe_url`, enter wait mode. No local git ops. | -| `error` | Wait 60s and loop | - -**Statuses requiring action** — see subsections below: - -| Status | Summary | -| ------------------------ | --------------------------------------------------------------------------------- | -| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | -| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | -| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | -| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | -| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | -| `environment_issue` | Request environment rerun via MCP (gate check first). | -| `self_healing_throttled` | Reject old fixes, attempt local fix. | -| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | -| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | - -### fix_apply_ready - -- Spawn UPDATE_FIX subagent with `APPLY` -- Record `last_cipe_url`, enter wait mode - -### fix_needs_local_verify - -The script returns `verifiableTaskIds` in its output. - -1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` -2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task -3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode -4. **If any fail** → Apply Locally + Enhance Flow (see below) - -### fix_needs_review - -Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): - -- If fix looks correct → apply via MCP -- If fix needs enhancement → Apply Locally + Enhance Flow -- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow - -### fix_failed / no_fix - -Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. - -### environment_issue - -1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -3. Enter wait mode with `last_cipe_url` set - -### self_healing_throttled - -Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. - -1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) -2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` -3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. -4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode - -### no_new_cipe - -1. Report to user: no CI attempt found, suggest checking CI provider -2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode -3. Otherwise: exit with guidance - -### cipe_no_tasks - -1. Report to user: CI failed with no tasks recorded -2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode -3. If retry also returns `cipe_no_tasks`: exit with failure - -## Fix Action Flows - -### Apply via MCP - -Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. - -### Apply Locally + Enhance Flow - -1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) -2. Enhance code to fix failing tasks -3. Run failing tasks to verify -4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. -5. If passing → commit and push, enter wait mode - -### Reject + Fix From Scratch Flow - -1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. -2. Spawn UPDATE_FIX subagent with `REJECT` -3. Fix from scratch locally -4. Commit and push, enter wait mode - -### Environment vs Code Failure Recognition - -When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. - -**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. - -When detected → bail immediately, do NOT run gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. - -**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. - -### Git Safety - -- NEVER use `git add -A` or `git add .` — always stage specific files by name -- Users may have concurrent local changes that must NOT be committed - -### Commit Message Format - -```bash -git commit -m "fix(): - -Failed tasks: , -Local verification: passed|enhanced|failed-pushing-to-ci" -``` +| Status | Default Behavior | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `ci_success` | Exit with success | +| `cipe_canceled` | Exit, CI was canceled | +| `cipe_timed_out` | Exit, CI timed out | +| `polling_timeout` | Exit, polling timeout reached | +| `circuit_breaker` | Exit, no progress after 5 consecutive polls | +| `environment_rerun_cap` | Exit, environment reruns exhausted | +| `fix_auto_applying` | Self-healing is handling it — just record `last_cipe_url`, enter wait mode. No MCP call or local git ops needed. | +| `error` | Wait 60s and loop | + +**Statuses requiring action** — when handling these in Step 3, read `references/fix-flows.md` for the detailed flow: + +| Status | Summary | +| ------------------------ | --------------------------------------------------------------------------------------------- | +| `fix_auto_apply_skipped` | Fix verified but auto-apply skipped (e.g., loop prevention). Inform user, offer manual apply. | +| `fix_apply_ready` | Fix verified (all tasks or e2e-only). Apply via MCP. | +| `fix_needs_local_verify` | Fix has unverified non-e2e tasks. Run locally, then apply or enhance. | +| `fix_needs_review` | Fix verification failed/not attempted. Analyze and decide. | +| `fix_failed` | Self-healing failed. Fetch heavy data, attempt local fix (gate check first). | +| `no_fix` | No fix available. Fetch heavy data, attempt local fix (gate check first) or exit. | +| `environment_issue` | Request environment rerun via MCP (gate check first). | +| `self_healing_throttled` | Reject old fixes, attempt local fix. | +| `no_new_cipe` | CI Attempt never spawned. Auto-fix workflow or exit with guidance. | +| `cipe_no_tasks` | CI failed with no tasks. Retry once with empty commit. | + +**Key rules (always apply):** + +- **Git safety**: Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets +- **Environment failures** (OOM, command not found, permission denied): bail immediately. These aren't code bugs, so spending local-fix budget on them is wasteful +- **Gate check**: Run `ci-state-update.mjs gate` before local fix attempts — if budget exhausted, print message and exit ## Main Loop @@ -287,16 +170,7 @@ Determine select fields based on mode: - **Wait mode**: use WAIT_FIELDS (`cipeUrl,commitSha,cipeStatus`) - **Normal mode (first poll or after newCipeDetected)**: use LIGHT_FIELDS -``` -Task( - agent: "ci-monitor-subagent", - model: haiku, - prompt: "FETCH_STATUS for branch ''. - select: ''" -) -``` - -The subagent calls `ci_information` and returns a JSON object with the requested fields. This is a **foreground** call — wait for the result. +Call the `ci_information` tool with the determined `select` fields for the current branch. Wait for the result before proceeding. #### 2b. Run decision script @@ -350,16 +224,16 @@ When decision script returns `action == "done"`: 6. **If action expects new CI Attempt**, update tracking (see Step 3a) 7. If action results in looping, go to Step 2 -#### Spawning subagents for actions +#### Tool calls for actions -Several statuses require fetching heavy data or calling MCP: +Several statuses require fetching additional data or calling tools: -- **fix_apply_ready**: Spawn UPDATE_FIX subagent with `APPLY` -- **fix_needs_local_verify**: Spawn FETCH_HEAVY subagent for fix details before local verification -- **fix_needs_review**: Spawn FETCH_HEAVY subagent → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` -- **fix_failed / no_fix**: Spawn FETCH_HEAVY subagent → get `taskFailureSummaries` for local fix context -- **environment_issue**: Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` -- **self_healing_throttled**: Spawn FETCH_HEAVY subagent → get `selfHealingSkipMessage`; then FETCH_THROTTLE_INFO + UPDATE_FIX for each old fix +- **fix_apply_ready**: Call `update_self_healing_fix` with action `APPLY` +- **fix_needs_local_verify**: Call `ci_information` with HEAVY_FIELDS for fix details before local verification +- **fix_needs_review**: Call `ci_information` with HEAVY_FIELDS → get `suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries` +- **fix_failed / no_fix**: Call `ci_information` with HEAVY_FIELDS → get `taskFailureSummaries` for local fix context +- **environment_issue**: Call `update_self_healing_fix` with action `RERUN_ENVIRONMENT_STATE` +- **self_healing_throttled**: Call `ci_information` with HEAVY_FIELDS → get `selfHealingSkipMessage`; then call `update_self_healing_fix` for each old fix ### Step 3a: Track State for New-CI-Attempt Detection diff --git a/.opencode/skills/monitor-ci/references/fix-flows.md b/.opencode/skills/monitor-ci/references/fix-flows.md new file mode 100644 index 00000000000..b33aa02167b --- /dev/null +++ b/.opencode/skills/monitor-ci/references/fix-flows.md @@ -0,0 +1,108 @@ +# Detailed Status Handling & Fix Flows + +## Status Handling by Code + +### fix_auto_apply_skipped + +The script returns `autoApplySkipReason` in its output. + +1. Report the skip reason to the user (e.g., "Auto-apply was skipped because the previous CI pipeline execution was triggered by Nx Cloud") +2. Offer to apply the fix manually — spawn UPDATE_FIX subagent with `APPLY` if user agrees +3. Record `last_cipe_url`, enter wait mode + +### fix_apply_ready + +- Spawn UPDATE_FIX subagent with `APPLY` +- Record `last_cipe_url`, enter wait mode + +### fix_needs_local_verify + +The script returns `verifiableTaskIds` in its output. + +1. **Detect package manager:** `pnpm-lock.yaml` → `pnpm nx`, `yarn.lock` → `yarn nx`, otherwise `npx nx` +2. **Run verifiable tasks in parallel** — spawn `general` subagents for each task +3. **If all pass** → spawn UPDATE_FIX subagent with `APPLY`, enter wait mode +4. **If any fail** → Apply Locally + Enhance Flow (see below) + +### fix_needs_review + +Spawn FETCH_HEAVY subagent, then analyze fix content (`suggestedFixDescription`, `suggestedFixSummary`, `taskFailureSummaries`): + +- If fix looks correct → apply via MCP +- If fix needs enhancement → Apply Locally + Enhance Flow +- If fix is wrong → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. Otherwise → Reject + Fix From Scratch Flow + +### fix_failed / no_fix + +Spawn FETCH_HEAVY subagent for `taskFailureSummaries`. Run `ci-state-update.mjs gate --gate-type local-fix` — if not allowed, print message and exit. Otherwise attempt local fix (counter already incremented by gate). If successful → commit, push, enter wait mode. If not → exit with failure. + +### environment_issue + +1. Run `ci-state-update.mjs gate --gate-type env-rerun`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `RERUN_ENVIRONMENT_STATE` +3. Enter wait mode with `last_cipe_url` set + +### self_healing_throttled + +Spawn FETCH_HEAVY subagent for `selfHealingSkipMessage`. + +1. **Parse throttle message** for CI Attempt URLs (regex: `/cipes/{id}`) +2. **Reject previous fixes** — for each URL: spawn FETCH_THROTTLE_INFO to get `shortLink`, then UPDATE_FIX with `REJECT` +3. **Attempt local fix**: Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed → skip to step 4. Otherwise use `failedTaskIds` and `taskFailureSummaries` for context. +4. **Fallback if local fix not possible or budget exhausted**: push empty commit (`git commit --allow-empty -m "ci: rerun after rejecting throttled fixes"`), enter wait mode + +### no_new_cipe + +1. Report to user: no CI attempt found, suggest checking CI provider +2. If `--auto-fix-workflow`: detect package manager, run install, commit lockfile if changed, enter wait mode +3. Otherwise: exit with guidance + +### cipe_no_tasks + +1. Report to user: CI failed with no tasks recorded +2. Retry: `git commit --allow-empty -m "chore: retry ci [monitor-ci]"` + push, enter wait mode +3. If retry also returns `cipe_no_tasks`: exit with failure + +## Fix Action Flows + +### Apply via MCP + +Spawn UPDATE_FIX subagent with `APPLY`. New CI Attempt spawns automatically. No local git ops. + +### Apply Locally + Enhance Flow + +1. `nx-cloud apply-locally ` (sets state to `APPLIED_LOCALLY`) +2. Enhance code to fix failing tasks +3. Run failing tasks to verify +4. If still failing → run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, commit current state and push (let CI be final judge). Otherwise loop back to enhance. +5. If passing → commit and push, enter wait mode + +### Reject + Fix From Scratch Flow + +1. Run `ci-state-update.mjs gate --gate-type local-fix`. If not allowed, print message and exit. +2. Spawn UPDATE_FIX subagent with `REJECT` +3. Fix from scratch locally +4. Commit and push, enter wait mode + +## Environment vs Code Failure Recognition + +When any local fix path runs a task and it fails, assess whether the failure is a **code issue** or an **environment/tooling issue** before running the gate script. + +**Indicators of environment/tooling failures** (non-exhaustive): command not found / binary missing, OOM / heap allocation failures, permission denied, network timeouts / DNS failures, missing system libraries, Docker/container issues, disk space exhaustion. + +When detected → bail immediately without running gate (no budget consumed). Report that the failure is an environment/tooling issue, not a code bug. + +**Code failures** (compilation errors, test assertion failures, lint violations, type errors) are genuine candidates for local fix attempts and proceed normally through the gate. + +## Git Safety + +- Stage specific files by name — `git add -A` or `git add .` risks committing the user's unrelated work-in-progress or secrets + +## Commit Message Format + +```bash +git commit -m "fix(): + +Failed tasks: , +Local verification: passed|enhanced|failed-pushing-to-ci" +``` diff --git a/.opencode/skills/monitor-ci/scripts/ci-poll-decide.mjs b/.opencode/skills/monitor-ci/scripts/ci-poll-decide.mjs index d14b54df090..5a296493320 100644 --- a/.opencode/skills/monitor-ci/scripts/ci-poll-decide.mjs +++ b/.opencode/skills/monitor-ci/scripts/ci-poll-decide.mjs @@ -76,6 +76,8 @@ const { failedTaskIds = [], verifiedTaskIds = [], couldAutoApplyTasks, + autoApplySkipped, + autoApplySkipReason, userAction, cipeUrl, commitSha, @@ -154,14 +156,15 @@ function isNewCipe() { // 13. self-healing in progress → poll (sh_running) // 14. flaky task auto-rerun → poll (flaky_rerun) // 15. fix auto-applied → poll (fix_auto_applied) -// 16. auto-apply: verification pending→ poll (verification_pending) -// 17. auto-apply: verified → done (fix_auto_applying) -// 18. fix: verification failed/none → done (fix_needs_review) -// 19. fix: all/e2e verified → done (fix_apply_ready) -// 20. fix: needs local verify → done (fix_needs_local_verify) -// 21. self-healing failed → done (fix_failed) -// 22. no fix available → done (no_fix) -// 23. fallback → poll (fallback) +// 16. auto-apply: skipped → done (fix_auto_apply_skipped) +// 17. auto-apply: verification pending→ poll (verification_pending) +// 18. auto-apply: verified → done (fix_auto_applying) +// 19. fix: verification failed/none → done (fix_needs_review) +// 20. fix: all/e2e verified → done (fix_apply_ready) +// 21. fix: needs local verify → done (fix_needs_local_verify) +// 22. self-healing failed → done (fix_failed) +// 23. no fix available → done (no_fix) +// 24. fallback → poll (fallback) // ============================================================ function classify() { @@ -209,6 +212,12 @@ function classify() { // --- Auto-apply path (couldAutoApplyTasks) --- if (couldAutoApplyTasks === true) { + if (autoApplySkipped === true) + return { + action: "done", + code: "fix_auto_apply_skipped", + extra: { autoApplySkipReason }, + }; if (verificationStatus === "NOT_STARTED" || verificationStatus === "IN_PROGRESS") return { action: "poll", code: "verification_pending" }; if (verificationStatus === "COMPLETED") return { action: "done", code: "fix_auto_applying" }; @@ -282,6 +291,10 @@ const messages = { // actionable fix_auto_applying: () => "Fix verified! Auto-applying...", + fix_auto_apply_skipped: (extra) => + `Fix verified but auto-apply was skipped. ${ + extra?.autoApplySkipReason ? `Reason: ${extra.autoApplySkipReason}` : "Offer to apply manually." + }`, fix_needs_review: () => `Fix available but needs review. Verification: ${verificationStatus || "N/A"}`, fix_apply_ready: () => "Fix available and verified. Ready to apply.", fix_needs_local_verify: (extra) => @@ -300,6 +313,7 @@ const messages = { const resetProgressCodes = new Set([ "ci_success", "fix_auto_applying", + "fix_auto_apply_skipped", "fix_needs_review", "fix_apply_ready", "fix_needs_local_verify", @@ -351,6 +365,7 @@ function buildOutput(decision) { // Add extras if (code === "new_cipe_detected") result.newCipeDetected = true; if (extra?.verifiableTaskIds) result.verifiableTaskIds = extra.verifiableTaskIds; + if (extra?.autoApplySkipReason) result.autoApplySkipReason = extra.autoApplySkipReason; console.log(JSON.stringify(result)); } diff --git a/.opencode/skills/nx-import/SKILL.md b/.opencode/skills/nx-import/SKILL.md index a5d078c2f81..b1cd381d3dd 100644 --- a/.opencode/skills/nx-import/SKILL.md +++ b/.opencode/skills/nx-import/SKILL.md @@ -3,13 +3,6 @@ name: nx-import description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. --- ---- - -name: nx-import -description: Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. - ---- - ## Quick Start - `nx import` brings code from a source repository or folder into the current workspace, preserving commit history. @@ -44,6 +37,25 @@ Read the nx docs if you have the tools for it. - **Always prefer the destination's existing conventions.** Source uses `libs/`but dest uses `packages/`? Import into `packages/` (`nx import packages/foo --source=libs/foo`). - If dest has no convention (empty workspace), ask the user. +### Application vs Library Detection + +Before importing, identify whether the source is an **application** or a **library**: + +- **Applications**: Deployable end products. Common indicators: + - _Frontend_: `next.config.*`, `vite.config.*` with a build entry point, framework-specific app scaffolding (CRA, Angular CLI app, etc.) + - _Backend (Node.js)_: Express/Fastify/NestJS server entrypoint, no `"exports"` field in `package.json` + - _JVM_: Maven `pom.xml` with `jar` or `war` and a `main` class; Gradle `application` plugin or `mainClass` setting + - _.NET_: `.csproj`/`.fsproj` with `Exe` or `WinExe` + - _General_: Dockerfile, a runnable entrypoint, no public API surface intended for import by other projects +- **Libraries**: Reusable packages consumed by other projects. Common indicators: `"main"`/`"exports"` in `package.json`, Maven/Gradle packaging as a library jar, .NET `Library`, named exports intended for import by other packages. + +**Destination directory rules**: + +- Applications → `apps/`. Check workspace globs (e.g. `pnpm-workspace.yaml`, `workspaces` in root `package.json`) for an existing `apps/*` entry. + - If `apps/*` is **not** present, add it before importing: update the workspace glob config and commit (or stage) the change. + - Example: `nx import apps/my-app --source=packages/my-app` +- Libraries → follow the dest's existing convention (`packages/`, `libs/`, etc.). + ## Common Issues ### pnpm Workspace Globs (Critical) @@ -218,6 +230,7 @@ Identify technologies in the source repo, then read and apply the matching refer Available references: +- `references/ESLINT.md` — ESLint projects: duplicate `lint`/`eslint:lint` targets, legacy `.eslintrc.*` linting generated files, flat config `.cjs` self-linting, `typescript-eslint` v7/v9 peer dep conflict, mixed ESLint v8+v9 in one workspace. - `references/GRADLE.md` - `references/JEST.md` — Jest testing: `@nx/jest/plugin` setup, jest.preset.js, testing deps by framework, tsconfig.spec.json, Jest vs Vitest coexistence, Babel transforms, CI atomization. - `references/NEXT.md` — Next.js projects: `@nx/next/plugin` targets, `withNx`, Next.js TS config (`noEmit`, `jsx: "preserve"`), auto-installing deps via wrong PM, non-Nx `create-next-app` imports, mixed Next.js+Vite coexistence. diff --git a/.opencode/skills/nx-import/references/ESLINT.md b/.opencode/skills/nx-import/references/ESLINT.md new file mode 100644 index 00000000000..0d4afb8d9d0 --- /dev/null +++ b/.opencode/skills/nx-import/references/ESLINT.md @@ -0,0 +1,109 @@ +## ESLint + +ESLint-specific guidance for `nx import`. For generic import issues (root deps, pnpm globs, project references), see `SKILL.md`. + +--- + +### How `@nx/eslint/plugin` Works + +`@nx/eslint/plugin` scans for ESLint config files and creates a lint target for each project. It detects **both** flat config files (`eslint.config.{js,mjs,cjs,ts,mts,cts}`) and legacy config files (`.eslintrc.{json,js,cjs,mjs,yml,yaml}`). + +**Plugin options (set during `nx add @nx/eslint`):** + +```json +{ + "plugin": "@nx/eslint/plugin", + "options": { + "targetName": "eslint:lint" + } +} +``` + +**Auto-installation**: `nx import` auto-detects ESLint config files and offers to install `@nx/eslint`. Accept the offer — it registers the plugin and updates `namedInputs.production` to exclude ESLint config files. + +--- + +### Duplicate `lint` and `eslint:lint` Targets + +After import, projects will have **two** lint-related targets if the source `package.json` has a `"lint"` npm script: + +- `eslint:lint` — inferred by `@nx/eslint/plugin`; has proper caching and input/output tracking +- `lint` — created by Nx from the npm script via `nx:run-script`; no caching intelligence, just wraps `npm run lint` + +**Fix**: Remove the `"lint"` script from each project's `package.json`. Keep `"lint:fix"` if present — there is no plugin-inferred equivalent for auto-fixing. + +--- + +### Legacy `.eslintrc.*` Configs Linting Generated Files + +When `@nx/eslint/plugin` runs `eslint .` on a project with a legacy `.eslintrc.*` config that uses `parserOptions.project`, it tries to lint **all** files in the project directory including: + +- Generated `dist/**/*.d.ts` files (not in tsconfig `include`) +- The `.eslintrc.js` config file itself (not in tsconfig `include`) + +This causes `Parsing error: ESLint was configured to run on X using parserOptions.project, however that TSConfig does not include this file`. + +**Fix**: Add `ignorePatterns` to the `.eslintrc.*` config: + +```json +// .eslintrc.json +{ + "ignorePatterns": ["dist/**"] +} +``` + +```js +// .eslintrc.js — also ignore the config file itself since module.exports isn't in tsconfig +module.exports = { + ignorePatterns: ["dist/**", ".eslintrc.js"], + // ... +}; +``` + +--- + +### Flat Config `.cjs` Files Self-Linting + +When a project uses `eslint.config.cjs` (CJS flat config), `eslint .` lints the config file itself. The `require()` call on line 1 triggers `@typescript-eslint/no-require-imports`. + +**Fix**: Add the config filename to the top-level `ignores` array: + +```js +module.exports = tseslint.config( + { + ignores: ["dist/**", "node_modules/**", "eslint.config.cjs"], + }, + // ... +); +``` + +The same applies to `eslint.config.js` in a CJS project (no `"type": "module"`) if it uses `require()`. + +--- + +### `typescript-eslint` Version Conflict With ESLint 9 + +`typescript-eslint@7.x` declares `peerDependencies: { "eslint": "^8.56.0" }`, but it is commonly used alongside `"eslint": "^9.0.0"`. npm treats this as a hard peer dep conflict and refuses to install. + +**Root cause**: `@nx/eslint` init adds `eslint@~8.57.0` at the workspace root (for its own peer deps). Workspace packages that request `eslint@^9.0.0` + `typescript-eslint@^7.0.0` trigger the conflict when npm resolves their deps. + +**Fix**: Upgrade `typescript-eslint` from `^7.0.0` to `^8.0.0` directly in the affected workspace package's `package.json`. The `tseslint.config()` API and `tseslint.configs.recommended` are identical between v7 and v8 — no config changes needed. + +```json +// packages/my-package/package.json +{ + "devDependencies": { + "typescript-eslint": "^8.0.0" + } +} +``` + +**Note**: npm's root-level `"overrides"` field does not force versions for workspace packages' direct dependencies — update each package.json individually. + +--- + +### Mixed ESLint v8 and v9 in One Workspace + +Legacy v8 and flat-config v9 packages can coexist in the same workspace. Each package resolves its own `eslint` version. The root `eslint@~8.57.0` (added by `@nx/eslint` init) is used by legacy v8 packages; v9 packages get their own hoisted `eslint@9`. + +`@nx/eslint/plugin` infers `eslint:lint` targets for **both** config formats. Legacy packages run ESLint v8 with `.eslintrc.*`; flat-config packages run ESLint v9 with `eslint.config.*`. No special nx.json configuration is needed to support both simultaneously. diff --git a/.opencode/skills/nx-import/references/NEXT.md b/.opencode/skills/nx-import/references/NEXT.md index 12466d6ba5f..d9ec1f0b557 100644 --- a/.opencode/skills/nx-import/references/NEXT.md +++ b/.opencode/skills/nx-import/references/NEXT.md @@ -54,6 +54,20 @@ Next.js app tsconfigs have unique patterns compared to Vite: Imported Next.js configs may have `// eslint-disable-next-line @typescript-eslint/no-var-requires` but the project ESLint config enables different rule sets. This produces `Unused eslint-disable directive` warnings. Harmless — remove the comment or ignore. +### `@nx/next:init` Rewrites All npm Scripts (Whole-Repo Import) + +When `@nx/next:init` runs during a whole-repo import, it rewrites the project's `package.json` scripts to prefixed `nx` calls: + +```json +{ + "dev": "nx next:dev", + "build": "nx next:build", + "start": "nx next:start" +} +``` + +This is the standard "npm Script Rewriting" issue from SKILL.md, but triggered by `@nx/next:init` rather than Nx init. **Fix**: Remove all rewritten scripts from `package.json` — `@nx/next/plugin` infers all targets from `next.config.*`. + --- ## Non-Nx Source (create-next-app) @@ -66,6 +80,10 @@ For single-project `create-next-app` repos, use whole-repo import into a subdire nx import /path/to/source apps/web --ref=main --source=. --no-interactive ``` +### `next-env.d.ts` + +`next build` auto-generates `next-env.d.ts` at the project root. Add `next-env.d.ts` to the dest root `.gitignore` — it is framework-generated and should not be committed. + ### ESLint: Self-Contained `eslint-config-next` `create-next-app` generates a flat ESLint config using `eslint-config-next` (which bundles its own plugins). This is **self-contained** — no root `eslint.config.mjs` needed, no `@nx/eslint-plugin` dependency. The `@nx/eslint/plugin` detects it and creates a lint target. @@ -123,17 +141,19 @@ No naming conflicts between frameworks. ## Fix Order — Nx Source (Subdirectory Import) -1. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) -2. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` -3. ESLint setup (see SKILL.md: "Root ESLint Config Missing") -4. Jest setup (see SKILL.md: "Jest Preset Missing") -5. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` +1. Import Next.js apps into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, root deps, `.gitkeep` removal, frontend tsconfig base settings, `@nx/react` typings) +3. Install Next.js-specific deps: `pnpm add -wD @next/eslint-plugin-next` +4. ESLint setup (see SKILL.md: "Root ESLint Config Missing") +5. Jest setup (see SKILL.md: "Jest Preset Missing") +6. `nx reset && nx sync --yes && nx run-many -t typecheck,build,test,lint` ## Fix Order — Non-Nx Source (create-next-app) -1. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) -2. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) -3. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) +1. Import into `apps/` (see SKILL.md: "Application vs Library Detection") +2. Generic fixes from SKILL.md (pnpm globs, stale files cleanup, script rewriting, target name prefixing) +3. (Optional) If app needs to export types for other workspace projects: fix `noEmit` → `composite` (see SKILL.md) +4. `nx reset && nx run-many -t next:build,eslint:lint` (or unprefixed names if renamed) --- @@ -168,6 +188,16 @@ No naming conflicts between frameworks. - No test setup (create-next-app doesn't include tests) - All targets green: next:build, eslint:lint +### Scenario 4: Non-Nx create-next-app (alongside Vite, React Router 7, TanStack, CRA) → TS preset (PASS) + +- See VITE.md Scenario 6 for the full multi-import scenario +- Next.js-specific findings: + 1. `@nx/next:init` rewrote all scripts to `nx next:*` format — removed all rewritten scripts + 2. Stale files: `node_modules/`, `package-lock.json`, `.gitignore` — deleted (npm workspace, no pnpm files) + 3. ESLint self-contained via `eslint-config-next` — no root config needed + 4. No tsconfig changes needed — `noEmit: true` stays; `next build` handles type checking +- Targets: `next:build`, `next:dev`, `next:start`, `eslint:lint` + ### Scenario 5: Mixed Next.js (Nx) + Vite React (standalone) → TS preset (PASS) - Source A: CNW next preset (Next.js 16, App Router) — subdirectory import of `apps/` diff --git a/.opencode/skills/nx-import/references/VITE.md b/.opencode/skills/nx-import/references/VITE.md index 58ea909c6eb..5b3817eba42 100644 --- a/.opencode/skills/nx-import/references/VITE.md +++ b/.opencode/skills/nx-import/references/VITE.md @@ -43,6 +43,71 @@ See SKILL.md for the generic noEmit→composite fix. Vite-specific additions: --- +## React Router 7 (Vite-Based) + +React Router 7 (`@react-router/dev`) uses Vite under the hood with a `vite.config.ts` and a `react-router.config.ts`. The `@nx/vite/plugin` detects `vite.config.ts` and creates inferred targets. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `serve` targets. The `build` target invokes the script defined in `package.json` (usually `react-router build`), not `vite build` directly. + +**No separate typecheck target from `@nx/vite/plugin`** — React Router 7 typegen is run as part of `typecheck` (e.g. `react-router typegen && tsc`). The `typecheck` target is inferred from the tsconfig. Keep the `typecheck` script in `package.json` if present; it is not rewritten. + +### tsconfig Notes + +React Router 7 uses a single `tsconfig.json` (no `tsconfig.app.json`/`tsconfig.node.json` split). It includes: + +- `"rootDirs": [".", "./.react-router/types"]` — for generated type files; keep as-is +- `"paths": { "~/*": ["./app/*"] }` — self-referential alias; keep as-is +- `"noEmit": true` — replace with composite settings per SKILL.md + +### Build Output + +React Router 7 outputs to `build/` (not `dist/`). Add `build` to the dest root `.gitignore`. + +### Generated Types Directory + +React Router 7 generates `.react-router/` at the project root for route type generation. Add `.react-router` to the dest root `.gitignore`. + +--- + +## TanStack Start (Vite-Based) + +TanStack Start uses Vinxi under the hood, which wraps Vite. Projects have a standard `vite.config.ts` that `@nx/vite/plugin` detects normally. + +### Targets + +`@nx/vite/plugin` creates `build`, `dev`, `preview`, `serve-static`, `typecheck` targets. The `build` target runs `vite build` which invokes the TanStack Start Vinxi pipeline (produces both client and SSR bundles). + +### tsconfig Notes + +TanStack Start uses a single `tsconfig.json` with `"allowImportingTsExtensions": true` and `"noEmit": true`. Apply the standard noEmit → composite fix. `allowImportingTsExtensions` is compatible with `emitDeclarationOnly: true` — no change needed. + +### `paths` Aliases + +TanStack Start commonly uses `"#/*": ["./src/*"]` and `"@/*": ["./src/*"]`. These are self-referential — keep as-is for a single-project app. + +### Uncommitted Source Repo + +`create-tan-stack` initializes a git repo but does NOT make an initial commit. Before importing, commit first: + +```bash +git -C /path/to/source add . && git -C /path/to/source commit -m "Initial commit" +``` + +### Generated and Build Directories + +TanStack Start / Vinxi / Nitro generate several directories that must be added to the dest root `.gitignore`: + +- `.vinxi` — Vinxi build cache +- `.tanstack` — TanStack generated files +- `.nitro` — Nitro build artifacts +- `.output` — server-side build output (SSR/edge) + +These are not covered by `dist` or `build`. + +--- + ## React-Specific ### React Dependencies @@ -195,6 +260,42 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t --- +## Redundant npm Scripts After Import + +`nx import` copies `package.json` verbatim, so npm scripts come along. For Vite-based projects `@nx/vite/plugin` already infers the same targets from `vite.config.ts` — the npm scripts just shadow the plugin with weaker `nx:run-script` wrappers (no first-class caching inputs/outputs). Remove them after import. + +### Standalone Vite App (`create-vite`) + +Remove the following scripts — every one is redundant: + +| Script | Plugin replacement | +| ----------------------------- | ---------------------------------------------------------------------------- | +| `dev: vite` | `@nx/vite/plugin` → `dev` | +| `build: tsc -b && vite build` | `@nx/vite/plugin` → `build`; `typecheck` via `@nx/js/typescript` handles tsc | +| `preview: vite preview` | `@nx/vite/plugin` → `preview` | +| `lint: eslint .` | `@nx/eslint/plugin` → `eslint:lint` | + +### TanStack Start + +Remove `build`, `dev`, `preview`, and `test` scripts, but move any hardcoded `--port` flag to `vite.config.ts` first: + +```ts +// vite.config.ts +export default defineConfig({ + server: { port: 3000 }, // replaces `vite dev --port 3000` + ... +}) +``` + +### React Router 7 — Keep ALL scripts + +Do **not** remove React Router 7 scripts. They use the framework CLI (`react-router build`, `react-router dev`, `react-router-serve`) which is not interchangeable with plain `vite`: + +- `typecheck` runs `react-router typegen && tsc` — typegen must precede `tsc` or it fails on missing route types +- `start` serves the SSR bundle — no plugin equivalent + +--- + ## Fix Orders ### Nx Source @@ -208,19 +309,43 @@ Remove `@nx/js/typescript` if all projects use Vite. Keep it (renamed to `"tsc-t ### Non-Nx Source (additional steps) +0. Import into `apps/` (see SKILL.md: "Application vs Library Detection") 1. Generic fixes from SKILL.md (stale files cleanup, pnpm globs, rewritten scripts, target name prefixing, noEmit→composite, ESLint handling) 2. Fix `noEmit` in **all** tsconfigs (app, node, etc. — non-Nx projects often have multiple) 3. Add `extends` to solution-style tsconfigs so root settings apply 4. Fix `resolve.alias` / `__dirname` / `baseUrl` 5. Ensure `types` include `vite/client` and `node` 6. Install `@nx/vite` manually if it failed during import -7. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores -8. Full verification +7. Remove redundant npm scripts so `@nx/vite/plugin` infers them natively (see "Redundant npm Scripts" section) +8. **Vue**: Add `outDir` + `**/*.vue.d.ts` to ESLint ignores +9. Full verification ### Multiple-Source Imports See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific: fix tsconfig `references` paths for alternate directories (`../../libs/` → `../../libs-beta/`). +### Non-Nx Source: React Router 7 + +1. Ensure source has at least one commit (see SKILL.md: "Source Repo Has No Commits") +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/react` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Add `build` and `.react-router` to dest root `.gitignore` +6. **Keep all npm scripts** — React Router 7 uses framework CLI (`react-router build/dev`), not plain vite (see "Redundant npm Scripts" above) +7. `npm install && nx reset && nx sync --yes` + +### Non-Nx Source: TanStack Start + +1. Ensure source has at least one commit — `create-tan-stack` does NOT auto-commit (see SKILL.md) +2. `nx import` whole-repo into `apps/` (see SKILL.md: "Application vs Library Detection") → auto-installs `@nx/vite`, `@nx/vitest` +3. Stale file cleanup: `node_modules/`, `package-lock.json`, `.gitignore` +4. Fix `tsconfig.json`: `noEmit` → `composite + emitDeclarationOnly + outDir + tsBuildInfoFile` +5. Keep `allowImportingTsExtensions` — compatible with `emitDeclarationOnly: true` +6. Add `.vinxi`, `.tanstack`, `.nitro`, `.output` to dest root `.gitignore` +7. Move hardcoded `--port` from `dev` script into `vite.config.ts` (`server: { port: N }`) +8. Remove redundant npm scripts — `@nx/vite/plugin` infers `build`, `dev`, `preview`, `test` (see "Redundant npm Scripts" above) +9. `npm install && nx reset && nx sync --yes` + ### Quick Reference: React vs Vue | Aspect | React | Vue | @@ -232,3 +357,41 @@ See SKILL.md for generic multi-import (name collisions, dep refs). Vite-specific | ESLint parser | Standard TS | `vue-eslint-parser` + TS sub-parser | | ESLint setup | Straightforward | Must install deps before `@nx/eslint` | | Test utils | `@testing-library/react` | `@vue/test-utils` | + +### Quick Reference: Vite-Based React Frameworks + +| Aspect | Vite (standalone) | React Router 7 | TanStack Start | +| ------------------ | ----------------- | ----------------------- | ------------------------ | +| Build config | `vite.config.ts` | `vite.config.ts` | `vite.config.ts` | +| Build output | `dist/` | `build/` | `dist/` | +| SSR bundle | No | Yes (`build/server/`) | Yes (`dist/server/`) | +| tsconfig layout | app + node split | Single tsconfig | Single tsconfig | +| Auto-committed | Depends on tool | Usually yes | **No — commit first** | +| `nx import` plugin | `@nx/vite` | `@nx/vite`, `@nx/react` | `@nx/vite`, `@nx/vitest` | + +--- + +## Iteration Log + +### Scenario 6: Multiple non-Nx React apps (CRA, Next.js, React Router 7, TanStack Start, Vite) → TS preset (PASS) + +- Sources: 5 standalone non-Nx repos with different build tools +- Dest: CNW ts preset (Nx 22.5.1), npm workspaces, `packages/*` +- Import: whole-repo for each, sequential into `packages/` +- Pre-import fixes: + 1. Removed `packages/.gitkeep` and committed + 2. `git init && git add . && git commit` in Vite app (no git at all) + 3. `git add . && git commit` in TanStack app (git init'd but no commits) +- Import: `npm exec nx -- import packages/ --source=. --ref=main --no-interactive` + - Next.js import auto-installed `@nx/eslint`, `@nx/next` + - React Router 7 import auto-installed `@nx/vite`, `@nx/react`, `@nx/docker` (Dockerfile present) + - TanStack import auto-installed `@nx/vitest` +- Post-import fixes: + 1. Removed stale `node_modules/`, `package-lock.json`, `.gitignore` from each package + 2. Removed Nx-rewritten scripts from `board-games-nextjs/package.json` (had `"build": "nx next:build"`, etc.) + 3. Updated root `tsconfig.base.json`: `nodenext` → `bundler`, added `dom`/`dom.iterable` to lib, added `jsx: react-jsx` + 4. Added `build` to dest root `.gitignore` (CRA and React Router 7 output there) + 5. Fixed `noEmit` → `composite + emitDeclarationOnly` in: `board-games-vite/tsconfig.app.json`, `board-games-vite/tsconfig.node.json`, `board-games-react-router/tsconfig.json`, `board-games-tanstack/tsconfig.json` + 6. Fixed `tsBuildInfoFile` paths from `./node_modules/.tmp/...` to `./dist/...` + 7. Installed root `@types/react`, `@types/react-dom`, `@types/node` +- All targets green: `build` for all 5 projects; `typecheck` for Vite/React Router/TanStack; `next:build` for Next.js diff --git a/.opencode/skills/nx-workspace/SKILL.md b/.opencode/skills/nx-workspace/SKILL.md index ecd7aec061e..2b01d45353e 100644 --- a/.opencode/skills/nx-workspace/SKILL.md +++ b/.opencode/skills/nx-workspace/SKILL.md @@ -60,7 +60,6 @@ nx show project my-app --json | jq '.targets' nx show project my-app --json | jq '.targets.build' nx show project my-app --json | jq '.targets | keys' - # Check project metadata nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' ``` diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index c052fbf91e7..aa181acfa36 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -1,47 +1,53 @@ -# tsparticles — Project Initialization +# tsParticles — Project ## What This Is -tsparticles is a TypeScript monorepo that produces a modular particle engine library and multiple distribution bundles (basic, slim, full), along with demo applications. The codebase is used by web developers who want a lightweight, extensible particle system for browser-based visual effects and interactive demos. +tsParticles is a TypeScript-first, extensible particle engine and ecosystem packaged as a monorepo. It provides a compact runtime (`engine/src/`) plus plugins (`plugins/*/`), path generators (`paths/*/`), utility libraries (`utils/*/`), and prebuilt bundles (`bundles/*/`). This project produces library bundles, demos, and documentation for web developers building particle effects. ## Core Value -Provide a stable, well-tested, and easy-to-consume particle engine that can be published to npm as multiple curated bundles so consumers can pick the minimal footprint they need. +Provide a small, high-performance, and extensible particle engine that developers can integrate into web projects with minimal configuration. ## Requirements ### Validated -- ✓ Core engine runtime with public exports — existing (see `engine/src/`) -- ✓ Feature packages (shapes, updaters, plugins) with standardized hooks — existing (`shapes/*`, `updaters/*`, `plugins/*`) -- ✓ Bundles producing browser artifacts (webpack configs & `package.dist.json`) — existing (`bundles/*/`) +- ✓ Engine runtime and public API (`engine/src/index.ts`) — existing +- ✓ Plugin system and example plugin (`plugins/themes/src/`) — existing +- ✓ Bundles and build targets (`bundles/slim/`, `bundles/*/webpack.config.js`) — existing ### Active +- [ ] DEV-01: Stabilize build & CI across the monorepo (consistent Node/pnpm + Nx pipelines) +- [ ] DEV-02: Improve developer documentation and examples (expand `markdown/` and demo/vanilla) +- [ ] PERF-01: Reduce per-frame allocations in hot loops and add benchmarks for core update paths +- [ ] QA-01: Expand test coverage for rendering and physics (utilize `utils/tests/` fixtures) +- [ ] DX-01: Provide an easy local demo start (`demo/vanilla` quickstart improvements) + ### Out of Scope -- Native mobile SDKs — the project targets web-first consumption -- Backend services or hosted analytics — demos may use simple demo servers only +- Mobile native SDKs — this project targets web/browser bundles for now +- Paid plugin marketplace — commercial distribution is out of scope for initial roadmap ## Context -- Monorepo managed with `pnpm` and `nx` (root `package.json`, `pnpm-workspace.yaml`, `nx.json`). -- CI uses GitHub Actions (`.github/workflows/nodejs.yml`, `npm-publish.yml`) with Nx Cloud integration. -- Core code lives in `engine/src/`; feature packages live under `shapes/`, `updaters/`, `plugins/`; bundles under `bundles/*/`. -- Existing docs and examples: `typedoc.json`, `demo/vanilla/`, `.github` workflows. +- Monorepo managed with pnpm, Nx, and Lerna for publishing. Root scripts in `package.json` and workspace layout in `pnpm-workspace.yaml`. +- Typedoc is used for API docs (`typedoc.json`) and `markdown/` contains higher-level guides. +- Build outputs are produced via webpack under `bundles/*`. ## Constraints -- **Compatibility**: Support modern browsers; Node used for tests and CI (Node 18+/24 in CI). -- **Tooling**: `pnpm` (workspace) and `nx` required for local developer workflows. -- **Publishing**: Publishing via GitHub Actions and Lerna/Nx — requires repository secrets (NX_CLOUD_ACCESS_TOKEN, FIREBASE_SERVICE_ACCOUNT_TSPARTICLES). +- **Platform**: Browser-first; Node only for tooling and CI — runtime APIs must not rely on server features. +- **Compatibility**: Support modern evergreen browsers; minimize polyfills to keep bundles small. +- **Performance**: Hot-path code (particle update/render loop) needs careful allocation discipline. ## Key Decisions -| Decision | Rationale | Outcome | -| ----------------------- | --------------------------------------------- | ------- | -| Monorepo with pnpm + nx | Reuse existing structure and CI optimizations | ✓ Good | +| Decision | Rationale | Outcome | +| ----------------------------- | ---------------------------------------------------------------- | ------- | +| Monorepo with pnpm + Nx | Organize many small packages and speed local dev with workspaces | ✓ Good | +| Web-first, not server runtime | Primary consumers are web apps and demos | ✓ Good | --- -_Last updated: 2026-03-01 after initialization_ +_Last updated: after project initialization_ diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index 2f22a23f6df..573fbed5bfb 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -1,28 +1,54 @@ -# Requirements: tsparticles +# Requirements: tsParticles -**Defined:** 2026-03-01 -**Core Value:** Provide a stable, well-tested, and easy-to-consume particle engine with curated bundles for varying footprint needs. +**Defined:** auto-init +**Core Value:** Provide a small, high-performance, and extensible particle engine that developers can integrate into web projects with minimal configuration. ## v1 Requirements -- **PERF-01**: Optimize hot loops and reduce per-frame allocations (benchmark-driven). -- **BUNDLE-01**: Introduce automated bundle size budget checks in CI. +### Developer Experience + +- [ ] **DEV-01**: Scripts to install and build the workspace work with `pnpm` (`pnpm i`, `pnpm run build`) on a developer machine with Node 18+. +- [ ] **DEV-02**: Developer quickstart: `demo/vanilla` runs locally with a single command and clear README. + +### Stability & CI + +- [ ] **CI-01**: CI pipeline builds all packages and runs tests (`pnpm run build:ci` succeeds in CI). +- [ ] **CI-02**: Lint and format checks are enforced in pre-commit hooks (husky) and CI. + +### Performance + +- [ ] **PERF-01**: Particle update loop reduces per-frame heap allocations in the hot path by refactoring one identified example in `engine/src/Utils/`. +- [ ] **PERF-02**: Add a simple benchmark that measures updates per second for a configurable particle count. + +### Documentation + +- [ ] **DOC-01**: Typedoc-generated API docs are buildable (`pnpm run build:docs`) and published locally for reviewers. +- [ ] **DOC-02**: Add at least 2 end-to-end demo examples in `demo/vanilla` showcasing core plugin usage. + +## v2 Requirements + +- **DX-01**: Starter templates for common frameworks (React, Vue) demonstrating integration. ## Out of Scope -| Feature | Reason | -| --------------------- | ----------------------------------------------------- | -| Native mobile SDKs | Web-first library; mobile SDKs deferred to later work | -| Server-side analytics | Not core to engine functionality | +| Feature | Reason | +| ----------------------- | -------------------------------------------------- | +| Native mobile SDKs | Web-first focus for initial roadmap | +| Paid plugin marketplace | Commercialization beyond initial open-source scope | ## Traceability | Requirement | Phase | Status | | ----------- | ------- | ------- | -| CORE-01 | Phase 1 | Pending | -| CORE-02 | Phase 1 | Pending | -| TEST-01 | Phase 1 | Pending | +| DEV-01 | Phase 1 | Pending | +| DEV-02 | Phase 1 | Pending | +| CI-01 | Phase 1 | Pending | +| CI-02 | Phase 1 | Pending | +| PERF-01 | Phase 2 | Pending | +| PERF-02 | Phase 2 | Pending | +| DOC-01 | Phase 1 | Pending | +| DOC-02 | Phase 1 | Pending | --- -_Requirements defined: 2026-03-01_ +_Requirements defined: auto-init_ diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index a545c1a4a54..381c7a2f5bd 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -1,16 +1,28 @@ -# Roadmap — tsparticles +# ROADMAP: tsParticles (replaced) -**Created:** 2026-03-01 +## Overview ---- +Single focused phase per owner's request. -Phase Details +| # | Phase | Goal | +| --- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | +| 1 | External Interaction: Drag & Drop Particle | Implement an external interaction allowing users to drag-and-drop particles one at a time into a canvas and interact with them. | + +## Phase Details + +### Phase 1: External Interaction: Drag & Drop Particle + +Goal: Provide an external interaction that lets a user drag and drop single particles into the canvas, interact with them (select, move, drop), and expose a minimal API for external consumers to trigger and listen to these interactions. + +Requirements: (derived from owner request) + +- UI-01: Users can drag a particle from an external palette and drop it onto the canvas. Only one particle is dragged per interaction. +- UI-02: Dropped particle becomes interactive (can be selected and moved) until deselected. +- API-01: Emit events on drag-start, drag-end, drop, select, and move with particle identifiers and positions. +- QA-01: Add automated usability tests that simulate drag-and-drop and assert events fired. -**Phase 1: Core Stabilization** -Goal: Ensure core runtime is correct and covered by tests. -Requirements: CORE-01, CORE-02, TEST-01 Success criteria: -1. Unit tests covering engine core and utils pass reliably in CI. -2. Memoize/deepExtend issues addressed with tests. -3. Test fixtures for canvas/jsdom stabilized. +1. Functional demo shows drag-and-drop of one particle at a time into `demo/vanilla`. +2. Events are emitted and documented in a short API doc snippet. +3. Acceptance tests simulate a drag-and-drop and pass in CI. diff --git a/.planning/ROADMAP.md.bak b/.planning/ROADMAP.md.bak new file mode 100644 index 00000000000..6aa62ff6012 --- /dev/null +++ b/.planning/ROADMAP.md.bak @@ -0,0 +1,33 @@ + +# ROADMAP: tsParticles (backup) + +## Overview (backup) + +Phases derived from v1 requirements. Each requirement maps to a phase. + +| # | Phase | Goal | Requirements | +| --- | --------------------------- | ------------------------------------------------------- | ------------------------------ | +| 1 | Developer Experience & Docs | Make it easy to get started and contribute | DEV-01, DEV-02, DOC-01, DOC-02 | +| 2 | CI & Performance | Ensure builds/tests are reliable and optimize hot paths | CI-01, CI-02, PERF-01, PERF-02 | + +## Phase Details (backup) + +### Phase 1: Developer Experience & Docs + +Goal: New contributors can install, build, run demos, and understand core APIs. +Requirements: DEV-01, DEV-02, DOC-01, DOC-02 +Success criteria: + +1. `pnpm i` and `pnpm run build` succeed locally on standard Node version. +2. Demo site `demo/vanilla` runs and demonstrates plugin usage. +3. Typedoc-generated docs render without errors. + +### Phase 2: CI & Performance + +Goal: CI catches regressions and core engine hot paths are measurably improved. +Requirements: CI-01, CI-02, PERF-01, PERF-02 +Success criteria: + +1. CI builds and tests pass in CI environment. +2. Lint/format enforced in CI and pre-commit hooks. +3. Benchmark shows measurable allocation reduction in targeted hot path. diff --git a/.planning/STATE.md b/.planning/STATE.md index 742b104f805..577f7d0a9a6 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -1,100 +1,7 @@ ## Project Reference -See: .planning/PROJECT.md (updated 2026-03-01) +See: .planning/PROJECT.md (initialized) -**Core value:** Provide a stable, well-tested, and easy-to-consume particle engine with curated bundles for varying footprint needs. -**Current focus:** Phase 1: Core Stabilization +**Core value:** Provide a small, high-performance, and extensible particle engine that developers can integrate into web projects with minimal configuration. -## Last Execution - -- Last executed plan: 01-core-stabilization / 01 -- Completed: 2026-03-03T11:21:30Z -- Tasks completed: 3/3 (TDD: RED → GREEN + fixture) -- Commits: - - 014d03f39b test(01-core-stabilization-01): add failing memoize tests - - b6185092dc feat(01-core-stabilization-01): implement bounded memoize with options - - 577b66d0e4 feat(01-core-stabilization-03): add deterministic canvas fixtures for jsdom/vitest - - 915a72368f docs(01-core-stabilization-01): add PLAN-SUMMARY for plan 01 execution - -## Recent Plans - -- 01-core-stabilization / 03 (fixtures + test:ci) -- Completed: 2026-03-01 -- Tasks completed: 2/2 -- Commits: - - 577b66d0e4 feat(01-core-stabilization-03): add deterministic canvas fixtures for jsdom/vitest - - 0dc83a85c4 chore(01-core-stabilization-03): make test:ci deterministic for CI - -- Plan 03 checkpoint: human approval recorded -- Approved at: 2026-03-03T10:22:45Z -- Finalized by agent at: 2026-03-03T11:40:18Z (UTC) - -- Plan 03 status: COMPLETE - -## Notes - -- Memoize implementation updated to support maxSize, ttlMs, and keyFn while preserving backward compatibility for memoize(fn) callers. -- Vitest tests for memoize added and pass locally when run with pnpm workspace test runner. - -## Recent Plan Execution (automated note) - -- Plan executed: 01-core-stabilization / 04 (research + CORE-02 audit) -- Files created and recorded in git (commits shown): - - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md (commit: db757cf24e) - - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md (commit: b8d614c99) - - .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md (commit: 12e95684b) - -Notes: The artifacts listed above are present in the repository index and their most-recent commits are recorded here for traceability. The previous local-finalize instructions were removed and replaced with the commit records. - -If you see missing commits locally, reconcile your branch with remote and reapply the commit as needed: - -git fetch origin -git rebase origin/$(git rev-parse --abbrev-ref HEAD) -git status --porcelain - -To re-create the commits locally if necessary: - -git add .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md \ - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md \ - .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md -git commit -m "docs(01-core-stabilization-04): add RESEARCH and CORE-02 audit" - -After committing locally, run the gsd-tools state advance command if available to update higher-level planning state. - -## Finalize instructions for local environment - -During automated execution this agent committed changes locally. The environment does not have the gsd-tools helper available for updating global planning state. If you see any git ref lock or commit errors when syncing remotely, run the following locally to finalize and ensure remote state is up to date: - -git fetch origin -git rebase origin/$(git rev-parse --abbrev-ref HEAD) -git add .planning/phases/01-core-stabilization/05-PLAN.md \ - .planning/phases/01-core-stabilization/VERIFICATION.md \ - .planning/phases/01-core-stabilization/06-PLAN-SUMMARY.md -git commit -m "docs(01-core-stabilization-06): finalize frontmatter fix and verification update" - -After committing, if available, run: - -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state advance-plan || true - -## Last Execution (most recent) - -- Last executed plan: 02-core-stabilization / 02 -- Completed: 2026-03-03T00:00:00Z -- Tasks completed: 2/2 -- Commits: - - b8d614c99 test(01-core-stabilization-02): add bundle size budgets test - - 12e95684c docs(01-core-stabilization-02): run bundle size test in CI workflow - - 82940c0da docs(01-core-stabilization-02): add PLAN summary for bundle size checks - -## Executed Plan - -- 01-core-stabilization / 05 -- Executed: 2026-03-03T10:21:59Z -- Actions: - - Created 01-core-stabilization-RESEARCH.md - - Generated VERIFICATION.md (plan-checker static run) - - Wrote 05-PLAN-SUMMARY.md and paused for human verification -- Commits: - - dd11a3cd7d chore(01-core-stabilization-05): add VERIFICATION.md from plan-checker - - f875349d26 docs(01-core-stabilization-05): add plan summary and verification results - - (checkpoint resolved) human approved at 2026-03-03T10:22:45Z +**Current focus:** Phase 1 — Developer Experience & Docs diff --git a/.planning/codebase/ARCHITECTURE.md b/.planning/codebase/ARCHITECTURE.md index eed2f71cabe..941ac5c80f3 100644 --- a/.planning/codebase/ARCHITECTURE.md +++ b/.planning/codebase/ARCHITECTURE.md @@ -1,131 +1,41 @@ -# Architecture +# ARCHITECTURE -**Analysis Date:** 2026-03-03 +High-level architecture -## Pattern Overview +- Purpose: tsParticles is a TypeScript-based particle engine and collection of plugins and paths. The repository is a monorepo containing engine core, plugins, utility libraries, and bundles. -Overall: modular monorepo with an engine core and plugin/bundle system +Primary layers -Key Characteristics: +- Engine (runtime): `engine/src/` — core particle system, utilities, and public exports (`engine/src/index.ts`). +- Plugins: `plugins/*/src/` — extend engine features (themes, etc.). +- Paths & generators: `paths/*/src/` — path generation algorithms and types. +- Utilities: `utils/*/src/` — helper libs (e.g., Perlin noise). +- Bundles: `bundles/*/` — assembly of UMD/ESM bundles through webpack. -- Central Engine core implemented in `engine/src/` that exposes a singleton via `engine/src/index.ts` and `engine/src/initEngine.ts`. -- Plugins, updaters, shapes, interactions and effects are small packages under top-level folders (`updaters/`, `interactions/`, `shapes/`, `plugins/`, `utils/`) and are dynamically loaded into the engine by bundles or manual registration. -- Bundles under `bundles/*/` compose multiple plugins for different distribution targets (e.g. `bundles/slim`, `bundles/full`, `bundles/pjs`) and provide convenience loader functions such as `bundles/slim/src/index.ts` → `loadSlim(engine)`. -- Demo apps under `demo/` (notably `demo/vanilla`) run the built packages and serve static assets, demonstrating public APIs. -- Utilities and small helper packages live under `utils/*/` and are published separately (e.g. `utils/perlinNoise`, `utils/noiseField`). +Public entry points -## Major Components +- Main runtime entry: `engine/src/index.ts` exports the core API. +- Bundled distribution entry: `bundles/*/src/index.ts` and `bundles/*/src/bundle.ts` for assembled bundles. -Engine Core +Data flow -- Purpose: runtime, container lifecycle, animation loop, plugin registry. -- Location: `engine/src/`. -- Key files: - - `engine/src/Core/Engine.ts` — central Engine class, plugin/preset/shape registries and `load`/`register` APIs. - - `engine/src/Core/Container.ts` — per-instance Container: lifecycle, animation loop, plugins, particles manager. - - `engine/src/Core/Canvas.ts` — canvas management and drawing (referenced from `Container`). - - `engine/src/index.ts`, `engine/src/initEngine.ts` — entry and global singleton export. +- Configuration (user options) flows into the Engine API which instantiates containers and particles. +- Plugins register updaters and renderers via plugin registration points; look for `Plugin` classes in `plugins/*/src/`. -Plugin & Extension Packages +Extensibility -- Purpose: extend engine with shapes, interactions, updaters, presets, effects. -- Location examples: `updaters/*/src/`, `interactions/external/*/src/`, `shapes/*/src/`. -- Pattern: each package exports a loader function (e.g. `loadExternalBounceInteraction`) which the bundles call to register the extension with an `Engine` instance. +- Plugin system with clear plugin interfaces (inspect `plugins/*/src/*Plugin.ts` and `ThemesPlugin.ts`). +- Paths and generators are separate packages that implement specific interfaces (e.g., `GridPathGenerator.ts`). -Bundles +Where to find architectural decisions -- Purpose: produce distributable bundles that glue engine + selected plugins and provide a single loader function for browsers/CDN. -- Location: `bundles/*/` (e.g. `bundles/slim`, `bundles/full`, `bundles/pjs`). -- Key file: `bundles/slim/src/index.ts` — demonstrates dynamic imports of many packages and calls their loader functions, then registers them via `engine.register`. -- Build outputs: `bundles/*/dist/` with UMD/CJS/ESM artifacts (e.g. `bundles/slim/dist/tsparticles.slim.bundle.js`). +- `engine/src/` — core abstractions and utility helpers (`EventDispatcher.ts`, `CanvasUtils.ts`). +- `plugins/*/` — plugin lifecycle and extension patterns. -Utilities +Notes on build & distribution -- Purpose: shared algorithms and small, publishable utilities. -- Location: `utils/*/` with `src/` and `dist/` (e.g. `utils/perlinNoise/src/PerlinNoise.ts`, `utils/noiseField/src/NoiseFieldGenerator.ts`). +- Bundles are constructed via webpack, producing format-specific outputs. `bundles/slim/` contains a trimmed bundle implementation. -Demo & Docs +Limitations & boundaries -- Purpose: examples and interactive playgrounds for the library. -- Location: `demo/vanilla/` and `demo/electron/`. -- Entry: `demo/vanilla/app.ts` starts an Express server that serves `views/*.pug` and `public/` assets and mounts built packages from `node_modules` under static paths. - -## Layers - -Runtime Layer (Engine): - -- Files: `engine/src/Core/*` and `engine/src/Utils/*`. -- Responsibility: creation of `Container` instances, plugin lifecycle, animation loop, drawing orchestration. - -Extension Layer (plugins/updaters/shapes/interactions): - -- Files: `updaters/*/src/*`, `interactions/*/src/*`, `shapes/*/src/*`. -- Responsibility: implement small behaviors (e.g. `updaters/size/src/SizeUpdater.ts`, `interactions/external/bounce/src/Bouncer.ts`). - -Bundle Layer: - -- Files: `bundles/*/src/*`, `bundles/*/dist/*`. -- Responsibility: aggregate plugin loaders and expose single convenience API (e.g. `loadSlim(engine)`). - -Presentation/Demo Layer: - -- Files: `demo/vanilla/app.ts`, `demo/vanilla/public/javascripts/*.js`, `demo/vanilla/views/*.pug`. -- Responsibility: demonstrate runtime usage, host assets and docs. - -Build & Distribution Layer: - -- The repo is a pnpm + Nx monorepo (root `package.json`, `pnpm-workspace.yaml`, `nx.json`), packages maintain `package.json` and `package.dist.json` where needed. Bundles provide compiled `dist/` outputs. - -## Data Flow - -1. Application code or bundle calls the engine entrypoint: `import { tsParticles } from "@tsparticles/engine";` or bundles call `loadSlim(tsParticles)`. -2. Engine initializes (via `init()` / `initEngine()`), runs registered loader functions (`engine.register(...)`) which call plugin loader functions. -3. When consumers call `engine.load({ id, options })`, Engine creates a `Container` (`new Container(this, id, options)`), which: - - creates `Canvas` and `Particles` managers, - - loads plugins for the container (via `plugin.getPlugin(container)`), and - - starts the animation loop using `requestAnimationFrame` wrappers (`animate()` in `Container._nextFrame`). See `engine/src/Core/Container.ts`. -4. Per-frame loop: `Container._nextFrame` computes delta, updates particles and canvas (`canvas.drawParticles(delta)`), and schedules next frame. - -Event Flow / PubSub - -- Engine includes an `EventDispatcher` used across engine and container (`engine/src/Utils/EventDispatcher.ts`). Events (container built, container init, container started, container destroyed, etc.) are dispatched by `Engine` and `Container`. API surface: `engine.addEventListener`, `engine.dispatchEvent`, `engine.removeEventListener`. - -Plugin Registration - -- Plugins expose loader functions which are passed to `engine.register` or called by bundles. Example: `bundles/slim/src/index.ts` imports `@tsparticles/interaction-external-bounce` and calls `loadExternalBounceInteraction(e)` where `e` is the Engine. - -Entry points - -- Library runtime: `engine/src/index.ts` (exports `tsParticles` and re-exports public API from `engine/src/exports.ts`). -- Bundle loader: `bundles/slim/src/index.ts` → `loadSlim(engine)`. -- Demo server: `demo/vanilla/app.ts` → Express app serving examples. - -Public APIs - -- Engine API (examples): - - `initEngine()` — creates Engine instance (`engine/src/initEngine.ts`). - - `Engine.load(params: ILoadParams)` — create Container and start it (`engine/src/Core/Engine.ts` lines ~449–488). - - `Engine.register(...loaders)` — register plugin loader functions before calling `load()` (`engine/src/Core/Engine.ts` lines ~522–534). - - `tsParticles` global singleton (set on `globalThis` in `engine/src/index.ts`). - -Distribution - -- Packages are built to `dist/` with UMD/CJS/ESM outputs. Example: `bundles/slim/dist/tsparticles.slim.bundle.js` and many module files under `bundles/slim/dist/`. - -Error handling and logging - -- Logger provided via `engine/src/Utils/LogUtils.ts` and used across engine to surface errors (e.g. animation loop try/catch in `Container._nextFrame`). - -Concurrency and loops - -- Per-container animation uses a requestAnimationFrame abstraction via `animate()` and `cancelAnimation()` (`engine/src/Core/Container.ts`, `engine/src/Utils/MathUtils.ts`), keeping each container decoupled. -- The engine's plugin init/loader process is asynchronous: `Engine.init()` awaits all registered loaders and ensures single-run semantics via sets `_executedSet` and `_loadPromises`. - -Notes and design decisions visible in code - -- Small packages export loader functions; bundles prefer dynamic `import()` for code-splitting and lazy loading (see `bundles/slim/src/index.ts` using `await Promise.all([ import("@tsparticles/...") ])`). -- Container lifecycle is explicit and self-contained; `Container.start()` → `init()` → plugin `start()` and `play()` sequence. - ---- - -_Architecture analysis: 2026-03-03_ +- No server components; architecture assumes client-side/browser execution for rendering, and Node only for tooling/builds. diff --git a/.planning/codebase/CONCERNS.md b/.planning/codebase/CONCERNS.md index 1788c78a326..e7a59a32f25 100644 --- a/.planning/codebase/CONCERNS.md +++ b/.planning/codebase/CONCERNS.md @@ -1,237 +1,25 @@ -# Codebase Concerns +# CONCERNS -**Analysis Date:** 2026-03-03 +Known risks & technical debt -This document enumerates technical debt, fragile areas, security and performance concerns, and maintenance risks found by scanning the repository. Each item includes the location (file paths), a severity rating, suggested mitigation, and tests/benchmarks required to validate the fix. +- Monorepo complexity: Nx + Lerna + pnpm adds cognitive overhead for contributors; ensure CI scripts are clear and well-documented. +- Publishing hygiene: multiple `publish:*` scripts (Lerna) — verify `bundles/*/package.dist.json` is updated if package boundaries change. ---- +Potential fragile areas -1. Global singletons & globalThis pollution +- Hot-path performance: particle update loops are performance-sensitive. Look for per-frame allocations in `engine/src/` utilities and updaters (e.g., `Utils.ts`, `MathUtils.ts`). +- Bundle configs: webpack configs under `bundles/*` can diverge; ensure consistent build target configs. -- Issue: Several packages attach public APIs or use globals on `globalThis`, creating implicit global state and potential collisions. - - Files: `engine/src/index.ts`, `engine/src/bundle.ts` (`globalThis.tsParticles = tsParticles`), - `bundles/fireworks/src/fireworks.ts` (sets `globalThis.fireworks`), - `bundles/confetti/src/confetti.ts` (sets `globalThis.confetti`), - `bundles/pjs/src/index.ts` (sets `globalThis.particlesJS`, `globalThis.pJSDom`, `globalThis.Particles`) -- Severity: Medium → High (library consumers can accidentally overwrite or depend on global state) -- Why it matters: Global exposure breaks encapsulation, makes testing harder, and risks conflicts when multiple versions or other libs define the same globals. -- Mitigation: - - Prefer explicit exports from bundles and avoid writing to `globalThis` by default. If a global is required for browser UMD builds, gate the global assignment behind an explicit bundler/build-time flag or `if (typeof globalThis !== "undefined" && !globalThis.__TSPARTICLES_GLOBAL__)` guard. - - Provide a small wrapper that conditionally assigns the global only when consumers opt into a global usage (e.g., UMD build or explicit init API). -- Tests/benchmarks: - - Unit tests that import bundles in a node/jsdom environment and assert no new globals are created unless a new `createGlobal` flag is passed. +Security & secrets ---- +- Repository is a library and currently contains no runtime secrets. Still, be careful when generating docs or examples that include API keys — add `.planning/codebase/` to review before commit. -2. Memoization implementation: heavy default keyer & unbounded/stale cache +Testing gaps -- Issue: `memoize` in `engine/src/Utils/Utils.ts` uses a default `stableStringify` keyer that deeply serializes arguments (including functions and symbols) and can be very expensive. Cache entries are only expired when accessed; TTL and maxSize defaults are absent which can lead to unbounded memory growth. -- Files: `engine/src/Utils/Utils.ts` (function `memoize`) -- Severity: High (CPU and memory pressure on hot-code paths if memoize used without options) -- Why it matters: Deep-serializing large objects on hot paths causes high CPU and memory churn. Unbounded caches leak memory in long-lived apps. -- Mitigation: - - Make the default behavior conservative: either require an explicit `keyFn` or set a reasonable default `maxSize` (e.g. 1000) and TTL (e.g. 60s) for library-level memoize uses. - - Provide documentation and clear examples showing when callers must pass a `keyFn` for complex objects. - - Replace the deep stable stringify with a lighter-weight, deterministic keyer for common cases (e.g., arrays/primitive args), and keep deep serialization only when caller opts in. - - Purge expired entries proactively (periodic sweep) or track insertion timestamps and evict on writes rather than only on read. -- Tests/benchmarks: - - Microbenchmarks comparing `memoize` default keyer vs. `keyFn` for common call shapes (primitive args, options objects). - - Memory/GC test that runs long-lived workload using default `memoize` without maxSize to show leak; then validate after mitigation. +- Ensure critical performance scenarios have benchmarks or stress tests; current tests mostly focus on correctness. ---- +Recommendations -3. deepExtend complexity & prototype-pollution edge-cases - -- Issue: `deepExtend` in `engine/src/Utils/Utils.ts` includes protections for dangerous keys (`__proto__`, `constructor`, `prototype`) but performs recursive merging with `deepExtend(undefined, v)` which can be expensive and may hit recursion limits for deeply nested structures. -- Files: `engine/src/Utils/Utils.ts` (`deepExtend`) -- Severity: Medium -- Why it matters: Unbounded recursion can cause call-stack overflows with malicious or deeply nested user-provided option objects. The function tries to mitigate prototype pollution, but complex object shapes or unusual prototypes could still be a risk. -- Mitigation: - - Add an explicit maximum recursion depth (configurable) and return/throw a clear error when exceeded. - - Add unit tests that target malicious inputs and deep nesting to ensure defensive behavior. - - Consider switching to an iterative merge algorithm for deep structures to avoid deep recursion on user inputs. -- Tests/benchmarks: - - Tests that pass objects with > 10k nesting depth and assert predictable behavior (error or safe truncation). - - Fuzz tests with keys containing `constructor`/`__proto__` to ensure no prototype pollution in real JS engines. - ---- - -4. Use of DOM APIs without robust server-side checks (safeDocument semantics) - -- Issue: `safeDocument()` currently returns `globalThis.document` without null-check. Many modules call `safeDocument().createElement(...)` and assume a Document will be present. -- Files: `engine/src/Utils/Utils.ts` (`safeDocument` and many uses), `plugins/trail/src/TrailPluginInstance.ts`, `plugins/backgroundMask/src/BackgroundMaskPluginInstance.ts`, `plugins/emittersShapes/path/src/EmittersPathShape.ts`, `shapes/image/src/ImageDrawer.ts`, `utils/canvasUtils/src/Utils.ts`, and many more (search results showed dozens). -- Severity: Medium -- Why it matters: Importing library code on the server (SSR, pre-rendering) will throw when `document` is undefined. Tests already rely on jsdom fixtures (mutating `globalThis.window`) to provide `document`; that pattern is fragile and can cause test order dependence. -- Mitigation: - - Change `safeDocument()` to return a typed optional (Document | undefined) and make callers handle the undefined case gracefully. - - For functions that _must_ access document (creating a canvas for offscreen work), add a defensive check and provide a clear error message instructing consumers to run under a DOM-like environment or to pass in a factory/helper. - - Consider an explicit library bootstrap API that accepts a DOM factory (for non-browser environments) instead of relying on `globalThis.document` implicitly. -- Tests/benchmarks: - - Add unit tests that import modules in a pure Node (no jsdom) environment and assert they either noop or throw a clear, documented error. - ---- - -5. Global usage for optional feature flags / filters via `globalThis` lookups - -- Issue: Several plugins accept a `filter` name (string) and look it up on `globalThis` (e.g. `plugins/emittersShapes/canvas/src/EmittersCanvasShape.ts`, `plugins/canvasMask`, `plugins/sounds`). This allows injecting external functions by populating the global scope. -- Files: `plugins/emittersShapes/canvas/src/EmittersCanvasShape.ts`, `plugins/canvasMask/src/Options/Classes/CanvasMaskPixels.ts`, `plugins/sounds/src/Options/Classes/SoundsEvent.ts`, `plugins/polygonMask/src/utils.ts` (accesses `globalThis.SVGPathSeg`) -- Severity: Medium -- Why it matters: The approach is brittle and encourages hidden dependencies via globals. It complicates bundling and breaks isolation; also it makes security auditing harder since global functions might be untrusted. -- Mitigation: - - Replace `globalThis` lookups with explicit registration APIs (e.g., `registerPixelFilter(name, fn)`), or accept function references in options (instead of string keys). - - Deprecate the global lookup pattern and log warnings when used. -- Tests/benchmarks: - - Tests verifying that the new registration API works and that legacy `globalThis` lookups emit a deprecation warning. - ---- - -6. Demo & playground code uses eval / innerHTML and user-controlled content - -- Issue: Demo files (`demo/vanilla/public/javascripts/playground.js`, `demo/vanilla/public/javascripts/demo.js`) call `eval(editor.getValue())` and set `innerHTML` with user content. -- Files: `demo/vanilla/public/javascripts/playground.js`, `demo/vanilla/public/javascripts/demo.js` (multiple innerHTML assignments) -- Severity: Low → Medium (demos only, not core library) but still dangerous for users running demos and for contributors testing locally -- Why it matters: `eval` and direct innerHTML can execute arbitrary code and facilitate XSS in hosted demos. They also make the demo code potentially unsafe to run with live user input. -- Mitigation: - - Replace `eval` with a safe sandbox or use Function constructors with clear scoping, or better, avoid running arbitrary user code. For demo code that must execute user input, run it inside an iframe with strict CSP. - - Avoid innerHTML for user-controlled content; use textContent or DOM creation APIs. -- Tests/benchmarks: - - Manual security review of demo pages; automated static analysis tools (for XSS) against demo files. - ---- - -7. setInterval / setTimeout lifecycle risks and potential leaks - -- Issue: Several modules use `setInterval`/`setTimeout` for short polling loops during initialization and for animations. If these timers are not cleared (race conditions or early returns), they may leak. -- Files: `bundles/fireworks/src/fireworks.ts` (initializing wait loop uses `setInterval`), `bundles/confetti/src/confetti.ts`, `interactions/external/particle/src/InteractivityParticleMaker.ts` (uses `_clearTimeout`), `plugins/polygonMask/src/PolygonMaskInstance.ts` (redrawTimeout), `plugins/poisson/src/PoissonDiscPluginInstance.ts` (redrawTimeout) -- Severity: Medium -- Why it matters: Leaked timers keep closures alive, cause memory leaks, and may cause behavior after components are destroyed. -- Mitigation: - - Ensure all timer handles are stored on instances and always cleared in cleanup/destroy paths. - - Replace polling `setInterval` initializing waits with Promise/async coordination where possible (e.g., wait for `initialized` via a Promise that resolves exactly once). If polling is required, add a timeout fallback and defensive cancellation. - - Audit all `.redrawTimeout`, `_clearTimeout`, and similar fields to ensure clearTimeout is always called in `destroy()`. -- Tests/benchmarks: - - Unit tests that create/destroy plugin instances and assert that no active timers remain (e.g., by spying on `setTimeout`/`setInterval` and `clearTimeout`/`clearInterval`). - ---- - -8. Use of dynamic `import()` for plugin loading with no graceful failure path - -- Issue: Bundles such as `bundles/fireworks` and `bundles/confetti` use dynamic `import()` to load optional plugins. If an import fails (missing package, networked ESM in some runtimes), the bundle rejects and higher-level APIs might not provide clear errors. -- Files: `bundles/fireworks/src/fireworks.ts`, `bundles/confetti/src/confetti.ts` (calls to `import("@tsparticles/...")`) -- Severity: Medium -- Why it matters: Dynamic imports make runtime behavior dependent on package resolution; failing to load optional plugin should degrade gracefully rather than throwing or blocking initialization. -- Mitigation: - - Wrap dynamic imports in try/catch and provide informative error messages and fallback behavior. - - Document the required peer packages or provide a single entry bundle that includes the common optional pieces for UMD consumers. -- Tests/benchmarks: - - Tests that simulate missing dynamic imports (mock the import to throw) and assert the API rejects with a descriptive error and does not leave partial state. - ---- - -9. Tests mutate global runtime and rely on shared global state (flaky test risk) - -- Issue: Tests in `utils/tests` frequently set `globalThis.window`, `globalThis.devicePixelRatio`, or assign `globalThis` properties. Tests also suppress many eslint rules and use `any` castings. -- Files: `utils/tests/src/tests/*`, `utils/tests/src/Fixture/*` (e.g., `Fixture/Window.ts`, `CustomCanvas.ts`, `fixtures/canvas-fixtures.ts`) -- Severity: Medium -- Why it matters: Mutating globals makes tests order-dependent and fragile when run in parallel (Vitest workers). Global mutations can leak between tests and cause flakiness. -- Mitigation: - - Use isolated jsdom per test file (Vitest supports per-file jsdom VMs) or reset global state in test setup/teardown (`beforeEach`/`afterEach`). - - Avoid `as any` and add typed wrappers for fixtures where practical to reduce `any` usage. - - Replace global devicePixelRatio mutation with a helper that saves/restores the original value. -- Tests/benchmarks: - - Run the test suite in parallel multiple times (CI job) to detect flakiness; add CI gating that fails when tests are nondeterministic. - ---- - -10. Large/minified legacy JS files and unmaintained shims (polygon pathseg) - -- Issue: `plugins/polygonMask/src/pathseg.js` is a large legacy shim that references `SVGPathElement.pathSegList` (deprecated) and contains `FIXME`/`TODO` comments. It also relies on globals. -- Files: `plugins/polygonMask/src/pathseg.js`, `plugins/polygonMask/src/utils.ts` (usage of `globalThis.SVGPathSeg`) -- Severity: Low → Medium (feature correctness risk across browsers) -- Why it matters: Using deprecated DOM APIs (SVGPathSeg) will break in modern browsers; large legacy file is hard to maintain or audit for bugs. -- Mitigation: - - Replace the legacy shim with a well-scoped modern implementation that uses current SVG path APIs, or detect and use alternate implementations. - - Add feature-detection tests and a graceful fallback to a safe shape-path generator if the browser lacks API support. -- Tests/benchmarks: - - Integration tests that exercise polygon mask behavior across browsers/renderer targets (headless chrome/jsdom equivalence checks). - ---- - -11. Remote asset references in library bundles - -- Issue: `bundles/fireworks/src/fireworks.ts` references audio files hosted at `https://particles.js.org/...`. -- Files: `bundles/fireworks/src/fireworks.ts` (audio URLs) -- Severity: Low → Medium (availability & privacy) -- Why it matters: Relying on remote assets at runtime introduces availability and privacy concerns and creates a runtime network dependency for demos and functionality that might be expected to be local. -- Mitigation: - - Ship a local fallback or bundle small assets with the demo package; make remote audio optional and document requirement. -- Tests/benchmarks: - - Unit tests that mock network fetches for audio and verify fallback paths. - ---- - -12. Performance: per-frame allocations & hot-path object churn - -- Issue: The engine performs many object allocations in frequently-called utility functions (e.g., collision math, vector rotations, memoize stable stringify), and some path/shape generators create temporary canvases/images via `createElement`. -- Files: `engine/src/Utils/Utils.ts` (e.g., `circleBounce`, `circleBounceDataFromParticle`), `engine/src/Utils/MathUtils.ts`, `utils/canvasUtils/src/Utils.ts`, various updaters/drawers -- Severity: Medium → High for high particle counts -- Why it matters: Per-frame allocations lead to GC pressure and jank at high particle counts or on low-end devices. -- Mitigation: - - Introduce object pooling for hot objects (Vectors, temporary bounds, collision data). The AGENTS.md already mentions pooling as a guideline — follow it for concrete hot-paths. - - Audit hot functions with a profiler and optimize expensive operations (avoid Math.hypot where micro-optimizations matter or reuse distance squared where possible). - - Avoid allocating DOM elements in render loops; reuse offscreen canvas instances per container instead of recreating them repeatedly. -- Tests/benchmarks: - - Add performance benchmarks that run typical particle configurations at varying counts (1k, 5k, 10k particles) and measure frame time and GC events. - - Use browser performance API or headless Chrome traces to validate reductions. - ---- - -13. Dependency & monorepo maintenance risks - -- Issue: The workspace uses many internal packages and dynamic plugin-loading expectations. Updating or removing internal workspace packages can break dynamic imports and bundles. -- Files: workspace root `package.json`, `pnpm-workspace.yaml`, dynamic imports in bundles/plugins -- Severity: Medium -- Why it matters: A monorepo with many packages requires coordinated dependency updates and clear deprecation policies; otherwise CI and published bundles risk breakage. -- Mitigation: - - Keep a clear compatibility matrix in docs for bundles and plugin package versions. - - Add CI checks that validate that dynamic imports referenced by bundles are present in the workspace or in published dependencies. -- Tests/benchmarks: - - CI job that builds all bundles and simulates missing peer packages to ensure graceful failures. - ---- - -14. Test coverage gaps and fragile visual/canvas tests - -- Issue: Canvas-heavy features and rendering behaviors are tested in `utils/tests` using jsdom and `canvas`/`canvas` package, but testing determinism for rendering is challenging. The repository's research notes already call out "flaky canvas tests". -- Files: `utils/tests/*`, `utils/tests/src/Fixture/*` -- Severity: Medium -- Why it matters: Rendering regressions are easy to introduce and hard to detect via unit tests; flakiness undermines developer confidence. -- Mitigation: - - Stabilize canvas tests: avoid timing-based assertions, prefer deterministic input and snapshot-based comparisons where feasible. - - Use fixtures and factories that isolate environmental differences (devicePixelRatio, window sizes) and ensure tests reset any global mutations. - - Add headless integration tests in CI (Chromium) that run a small set of deterministic rendering scenarios and capture golden images. -- Tests/benchmarks: - - CI image snapshot comparison job with tolerances for minor antialias differences. - ---- - -Priority summary (short-term): - -- High priority: Memoize default behavior (CPU/memory), Global `safeDocument` checks (SSR/test stability), Per-frame allocation hotspots (performance), Test isolation (flakiness) -- Medium priority: Global exposure via `globalThis`, dynamic import error handling, setInterval/timeouts cleanup, deepExtend recursion limits -- Low priority: Demo `eval`/innerHTML hardening, legacy pathseg file replacement, remote asset bundling - ---- - -If desired, I can generate a prioritized remediation plan with concrete code changes, test updates, and micro-benchmarks for the top 4 high-priority items. - -_Concise mapping of mentioned files (for quick navigation):_ - -- `engine/src/Utils/Utils.ts` (memoize, deepExtend, safeDocument, many helpers) -- `engine/src/Utils/MathUtils.ts` (animation loop abstraction, random, animate/cancel) -- `engine/src/Core/Utils/EventListeners.ts` (event listener lifecycle) -- `engine/src/index.ts`, `engine/src/bundle.ts` (globalThis exports) -- `bundles/fireworks/src/fireworks.ts`, `bundles/confetti/src/confetti.ts` (dynamic imports, globals, remote assets) -- `plugins/polygonMask/src/pathseg.js`, `plugins/polygonMask/src/utils.ts` (legacy SVGPathSeg usage) -- `plugins/*` and `shapes/*` (numerous safeDocument.createElement calls) -- `utils/tests/src/Fixture/*` and `utils/tests/src/tests/*` (fragile tests, global mutations) +1. Add CONTRIBUTING.md with local dev and release steps (pnpm, Node version, common Nx commands). +2. Add a `docs/` or top-level note describing release/publishing expectations for contributors. +3. Introduce a small performance checklist for PRs touching `engine/src/`. diff --git a/.planning/codebase/CONVENTIONS.md b/.planning/codebase/CONVENTIONS.md index a523a3273cc..c17df3f99ab 100644 --- a/.planning/codebase/CONVENTIONS.md +++ b/.planning/codebase/CONVENTIONS.md @@ -1,95 +1,33 @@ -# Coding Conventions +# CONVENTIONS -**Analysis Date:** 2026-03-03 +Coding style & linting -This document summarizes the repository-wide coding conventions you must follow when authoring code in this workspace. All items below reference concrete files and patterns present in the repository so they are actionable for implementers and automation. +- Prettier is enforced via `@tsparticles/prettier-config` (see `package.json` `prettify:readme` scripts). +- ESLint is present (`eslint` + `@tsparticles/eslint-config`) — prefer named imports and avoid default exports for library modules. -1. Formatting / Prettier +TypeScript & typing -- Prettier configuration is applied via the `prettier` field in package manifests. See the root `package.json` (`/package.json`) and many package-level `package.json` files that set: - - `"prettier": "@tsparticles/prettier-config"` (example: `bundles/all/package.json`, `plugins/zoom/package.json`). -- Commands that run formatting in CI or locally: - - `pnpm run prettify:readme` — formats README/markdown (root `package.json`, line 16-17). - - `pnpm exec prettier --write .` — full repository formatting (used ad-hoc). -- Recommended usage: - - Always run `pnpm exec prettier --write` before committing large edits when not covered by Husky hooks. - - For package-local operations prefer package scripts (see `utils/tests/package.json` scripts `prettify` / `prettify:ci`). +- Explicit types for public APIs; avoid `any`. Use `unknown` for untyped inputs and narrow with guards. +- Public option interfaces are declared under `engine/src/Options/Interfaces/` (follow naming and explicit interfaces). -2. Linting / ESLint +Imports & grouping -- A shared ESLint configuration package is used: `@tsparticles/eslint-config` (declared in root `package.json`, devDependencies). See per-package ESLint entrypoints such as `utils/tests/eslint.config.js` and dozens of `eslint.config.js` files across packages (examples: `updaters/tilt/eslint.config.js`, `shapes/square/eslint.config.js`). Those files import and re-export the shared config: - - `import tsParticlesESLintConfig from "@tsparticles/eslint-config";` (e.g. `utils/tests/eslint.config.js`). -- How to run linting: - - Package-local: `pnpm --filter run lint` (example `pnpm --filter @tsparticles/tests run lint`). - - Workspace/NX: `npx nx run :lint`. - - CI lint-check: `pnpm run lint:ci` in package scripts (see `utils/tests/package.json` line 12). -- ESLint ruleset expectations (implicit from shared config and repo conventions): - - Prefer explicit typing and avoid `any` on exported types. - - Favor `unknown` for untrusted inputs and narrow immediately. - - Enforce import ordering and group separation (external, workspace/internal, relative). +- Import grouping: 1) external packages, 2) workspace packages (e.g., `@tsparticles/engine`), 3) relative imports — separate with a blank line. -3. Import grouping and style +Naming -- Enforced and documented import order (see `AGENTS.md` and multiple `eslint.config.js` files): - 1. External packages (npm modules) — e.g. `import { expect } from "vitest";` - 2. Workspace packages (absolute package imports) — e.g. `import { deepExtend } from "@tsparticles/engine";` - 3. Relative imports (same package) — e.g. `import { helper } from "./helper";` -- Separation: leave a blank line between groups. Example from `utils/tests/src/tests/deepExtend.test.ts`: - - `import { describe, expect, it } from "vitest";` - - `import { deepExtend } from "@tsparticles/engine";` +- Classes & types: PascalCase (e.g., `GridPathGenerator`). +- Functions/variables: camelCase. +- Files exporting a class/major type: PascalCase filename matching the exported symbol. -4. Naming conventions +Error handling -- Files that export a class or main type use PascalCase filenames. Example policy in `AGENTS.md`: - - `TiltUpdater.ts` should export `TiltUpdater`. -- Use PascalCase for classes and types, camelCase for functions and variables, and UPPER_SNAKE_CASE only for true runtime-constant values. -- Test files: either `*.test.ts` (co-located tests) or `src/tests/*.ts` inside test packages (see `utils/tests/src/tests/`). +- Throw `Error` for unrecoverable issues; prefer returning `undefined` for optional results. -5. TypeScript and tsconfig +Performance notes -- Root `tsconfig.json` exists at `/tsconfig.json` and sets strict type checking with `"strict": true` and `esModuleInterop: true`. Many packages provide package-level `tsconfig.*.json` (examples: `bundles/slim/tsconfig.base.json`, `shapes/square/tsconfig.browser.json`). -- Shared tsconfig package: `@tsparticles/tsconfig` is present in `devDependencies` (root `package.json`). Use package-level configs for build targets (module / umd / types) as the repository already contains `tsconfig.module.json`, `tsconfig.umd.json`, `tsconfig.types.json` in packages. +- Avoid per-frame allocations in hot loops; reuse objects or pools where helpful (critical in particle engine updates). -6. Error handling +Commit & release -- Throw `Error` for unrecoverable conditions and prefer returning `undefined` for absent optional results (documented in `AGENTS.md`). Example defensive check in `utils/tests/src/tests/fixtures/canvas-fixtures.ts`: - - `if (typeof document === "undefined") { throw new Error("createDeterministicCanvas: document is not available in this environment"); }` -- Use typed Error subclasses for domain-specific failures when helpful. - -7. Exports & API surface - -- Public package APIs must be explicitly typed; avoid exporting `any`. Public option shapes should be declared under `engine/src/Options/Interfaces/*` (see `AGENTS.md` guidance). -- Prefer named exports across the workspace. Many packages use named imports/exports (examples: `@tsparticles/engine` used in tests). - -8. Performance & hot-path coding patterns - -- Avoid per-frame allocations in tight loops; reuse objects and consider pooling. This is a documented performance rule in `AGENTS.md` and applies to engine code under `engine/src/`. - -9. Tests and fixtures conventions (short) - -- Tests rely on deterministic fixtures: see `utils/tests/src/Fixture/` and `utils/tests/src/tests/fixtures/canvas-fixtures.ts` (seedable RNG, deterministic canvas size). -- Use `jsdom` environment for DOM tests and `canvas` package for headless canvas rendering (see `utils/tests/vitest.config.ts` and `utils/tests/package.json` dependencies). - -10. Commit / repo tooling expectations - -- Husky is enabled via `prepare` script (root `package.json` line 27). Do not bypass hooks. -- Commit messages must follow Conventional Commits and are validated by `@commitlint/config-conventional` (root `package.json` devDeps). - -Quick checklist for contributors - -- Run linter and formatter before opening PR: - - `pnpm --filter @tsparticles/tests run lint` (or package-specific lint) - - `pnpm --filter @tsparticles/tests run prettify` (or `pnpm exec prettier --write .`) -- Run tests locally (see TESTING.md for commands). - -References (concrete files): - -- Root manifest: `/package.json` (prettier field, devDependencies) -- Root TS config: `/tsconfig.json` -- Example ESLint entrypoint: `utils/tests/eslint.config.js` -- Per-package ESLint files: many `eslint.config.js` under package folders (e.g. `updaters/tilt/eslint.config.js`) -- Test fixtures: `utils/tests/src/Fixture/Window.ts`, `utils/tests/src/tests/fixtures/canvas-fixtures.ts` - ---- - -_Convention analysis: 2026-03-03_ +- Conventional commits enforced by commitlint dev dependency; follow `type(scope): description` convention. diff --git a/.planning/codebase/INTEGRATIONS.md b/.planning/codebase/INTEGRATIONS.md index 29625aeb5b8..ee33c6a51c3 100644 --- a/.planning/codebase/INTEGRATIONS.md +++ b/.planning/codebase/INTEGRATIONS.md @@ -1,77 +1,36 @@ -# External Integrations +# INTEGRATIONS -**Analysis Date:** 2026-03-03 +External services & integrations observed -This repository is a frontend-first TypeScript monorepo (libraries, bundles, demos) with CI/CD and publishing integrations. The integration points below reference concrete files. +- GitHub / CI: Repository uses GitHub; CI-related configs present under `.github/workflows/` and `nx-cloud` integration (`nx.json` + `nx-cloud` devDependency). +- Publishing: `lerna` is used for package publishing workflows (`package.json` scripts `version:*`, `publish:*`). +- npm registry: packages published via Lerna/NPM; check `bundles/*/package.dist.json` if publishing is needed. -## CI / CD +Datastores & network -- GitHub Actions workflows (repo-level): - - `.github/workflows/nodejs.yml` - primary CI that runs `pnpm install`, sets up Nx Cloud, runs `npx nx affected -t build:ci`, and conditionally deploys demo site to Firebase Hosting when `firebaseToken` secret is present. The workflow sets Node.js version 24 and uses `pnpm/action-setup`. See lines: env NX_CLOUD_ACCESS_TOKEN, firebaseToken usage for conditional deploys. (File: `.github/workflows/nodejs.yml`) - - `.github/workflows/npm-publish.yml` - publishes packages on push tags (v\*). It sets up Node.js 24 and uses OIDC/lerna to publish packages (`npx lerna publish from-package`) and determines dist-tags from tag name. (File: `.github/workflows/npm-publish.yml`) - - `.github/workflows/docs.yml` - scheduled daily job that runs `pnpm run build:ci:json` to produce docs JSON. (File: `.github/workflows/docs.yml`) - - `.github/workflows/codeql-analysis.yml` - GitHub CodeQL scanning enabled. (File: `.github/workflows/codeql-analysis.yml`) +- No application-level databases found in repository (it's a library/monorepo). No `db` or `migrations` folders. -## CI Cache & Remote Execution +Auth & external APIs -- Nx Cloud - remote caching and distributed execution configured in `nx.json` (`tasksRunnerOptions.default.runner: "nx-cloud"` and `nxCloudId` set). Workflows initialize Nx Cloud (see `npx nx-cloud start-ci-run` in `.github/workflows/*`). (Files: `nx.json`, `.github/workflows/*`) +- No third-party runtime APIs (OAuth, external REST APIs) integrated in source — repository is a UI/engine library. -## Package Publishing +Webhooks / integrations to watch -- Lerna + npm: publishing handled by Lerna invoked in CI (`npx lerna publish from-package --ignore-scripts` in `.github/workflows/npm-publish.yml`). Packages specify `publishConfig` to `directory: dist` and `access: public` in package manifests (examples: `bundles/all/package.json`, `engine/package.json`). Local scripts in root `package.json` include `publish:alpha`, `publish:beta`, `publish:next`, etc., which call `lerna` CLI. +- Dependabot configured (`.github/dependabot.yml`) for dependency updates. -## Hosting / Static Site +Developer integrations -- Firebase Hosting (conditional in CI): `.github/workflows/nodejs.yml` will deploy to Firebase Hosting when the `FIREBASE_SERVICE_ACCOUNT_TSPARTICLES` secret is present. The workflow uses `FirebaseExtended/action-hosting-deploy@v0` with `projectId: tsparticles` and `channelId: live`. (File: `.github/workflows/nodejs.yml`) +- Husky for git hooks (`prepare` script) — check `.husky/` if present in packages. +- GitHub Pages: `gh-pages` listed as devDependency — used for docs deployment (see `deploy.docs-json.js`). -- gh-pages/Docs - repository uses `gh-pages` devDependency and `typedoc` for docs generation. Root scripts `build:docs` and `deploy:docs:json` exist in `package.json` (File: `package.json`). The scheduled docs job runs `pnpm run build:ci:json` in `.github/workflows/docs.yml`. +Files & locations to review for integrations -## Telemetry & Security Scanning +- `.github/workflows/` — CI workflows +- `deploy.docs-json.js` — docs deployment logic +- `bundles/*/package.dist.json` — publishing metadata (if present) +- `package.json` — scripts for publishing and release -- CodeQL - configured in `.github/workflows/codeql-analysis.yml` to run security scanning for JavaScript. +Action items -- Nx Cloud telemetry / OpenTelemetry artifacts: `nx` and `nx-cloud` are in use; node modules include OpenTelemetry packages via nx cloud tooling (observed in `node_modules` and lockfiles). CI sets `NX_CLOUD_ACCESS_TOKEN` from GitHub secrets (see `.github/workflows/*`). (Files: `nx.json`, `.github/workflows/*`) - -## External APIs & Services - -- No direct third-party runtime APIs (Stripe, AWS, Supabase, etc.) are referenced in the repository source code. Grep across codebase shows imports primarily from internal workspace packages `@tsparticles/*` (see many `import` statements referencing `@tsparticles/engine` and other `@tsparticles` packages). (See `functions.grep` results and many `*.ts` files importing `@tsparticles/*`.) - -## Demo Server Integrations - -- Demo/Vanilla server (`demo/vanilla/package.json`) uses the following integrations for local demo serving and security: - - `express` - demo HTTP server (see `demo/vanilla/package.json` `devDependencies.express`). - - `helmet` - sets HTTP headers for security on demo server (see `demo/vanilla/package.json`). - - `dotenv` - demo server may read environment variables (note: `.env` files are present in repo but not read by this audit; existence only). (See `demo/vanilla/package.json` and `README.md` instructions.) - -## Analytics / Error Tracking - -- No project-level analytics (e.g., Google Analytics, Sentry) configured in source files. The README and site use external badges and links but there are no Sentry or GA integration code references in the library source. - -## Webhooks & Callbacks - -- The codebase does not define public webhook receivers for external services. CI workflows use GitHub Actions with `actions/checkout` and conditional deployment steps. No webhook endpoints in library packages. - -## Required Secrets / Environment Variables (referenced in CI) - -- `NX_CLOUD_ACCESS_TOKEN` - used by CI workflows to enable nx-cloud distributed execution (referenced in `.github/workflows/nodejs.yml`, `.github/workflows/npm-publish.yml`). -- `FIREBASE_SERVICE_ACCOUNT_TSPARTICLES` (and an env alias `firebaseToken`) - used to deploy demo site to Firebase Hosting from CI (`.github/workflows/nodejs.yml`). The secret name appears as `secrets.FIREBASE_SERVICE_ACCOUNT_TSPARTICLES`. -- `GITHUB_TOKEN` - used by GitHub Actions deploy steps (standard secret reference in workflows). (See `.github/workflows/*`.) - -Note: Do not expose secrets. `.env` files may exist for local demos but contents are not read or included in this document. - -## Observability / Logging - -- No repo-level APM or error-tracking integration code is present. Demo server `demo/vanilla` includes `winston` and `@datalust/winston-seq` packages (`demo/vanilla/package.json`) which enable structured logging and optional Seq ingestion in demo server runtime if configured. - -## Where integrations live (key file list) - -- Root manifest and scripts: `package.json` -- Nx Cloud & targets: `nx.json` -- GitHub Actions CI: `.github/workflows/nodejs.yml`, `.github/workflows/npm-publish.yml`, `.github/workflows/docs.yml`, `.github/workflows/codeql-analysis.yml`, `.github/workflows/lock.yml` -- Publishing configs: `bundles/*/package.json`, `engine/package.json`, and many package `package.json` files (they include `publishConfig` and `files: ["dist"]`). -- Webpack bundling for browser builds: `bundles/*/webpack.config.js`, `engine/webpack.config.js` and many `*/webpack.config.js` files under packages. -- Demo server: `demo/vanilla/package.json`, demo server source under `demo/vanilla/src` (if present). - ---- - -_Integration audit: 2026-03-03_ +- If you plan to add runtime integrations (APIs, DBs), document a top-level `INTEGRATIONS.md` (this file) with required env vars and secrets handling policy. +- Add a `.env.example` if any future packages require secrets for local testing. diff --git a/.planning/codebase/STACK.md b/.planning/codebase/STACK.md index 00e0d0b5f18..8c0507434b5 100644 --- a/.planning/codebase/STACK.md +++ b/.planning/codebase/STACK.md @@ -1,99 +1,51 @@ -# Technology Stack +# STACK -**Analysis Date:** 2026-03-03 +Project overview -## Languages +- Language: TypeScript (see `package.json` -> `typescript` dependency) +- Package manager: pnpm (see `packageManager` in `package.json` and `pnpm-workspace.yaml`) +- Monorepo tooling: Nx (`nx.json`) + Lerna used for publishing (`lerna` devDependency) +- Bundlers: Webpack (bundles/\*), SWC used as a transpiler in devDeps (`@swc/core`, `swc-loader`) +- Test runner: Vitest (`vitest` devDependency) -**Primary:** +Runtimes & targets -- TypeScript ^5.x - source language for all packages and demos. (See `package.json` root `devDependencies.typescript` and many `tsconfig*.json` files under package dirs, e.g. `tsconfig.json` at project root and `engine/tsconfig.json`.) +- Node.js for build scripts and tooling; browser targets for bundles (see `bundles/*/tsconfig.browser.json`). +- UMD/ESM bundles produced under `bundles/` (webpack configs in `bundles/*/webpack.config.js`). -**Secondary:** +Key dependencies and dev tooling -- JavaScript - emitted build artifacts and demo server code (bundles and `dist` outputs). See `bundles/*/package.json` (exports point to `dist/*`). +- Build and docs: `typedoc`, `typedoc-plugins` (see `typedoc.json`) +- Lint & formatting: `eslint`, `prettier` plus internal `@tsparticles/eslint-config` and `@tsparticles/prettier-config` +- CI helpers: `nx`, `nx-cloud` (see `nx.json`) -## Runtime +Workspace layout references -**Environment:** +- Core engine code: `engine/src/` and `engine/src/index.ts` +- Bundles: `bundles/slim/src/`, `bundles/slim/src/bundle.ts` +- Utility libs: `utils/perlinNoise/src/` +- Plugins: `plugins/themes/src/` +- Path generators: `paths/grid/src/` -- Node.js - CI uses Node.js 24 in GitHub Actions (`.github/workflows/nodejs.yml`, `.github/workflows/npm-publish.yml`, `.github/workflows/docs.yml`). +Configuration files to inspect -**Package Manager:** +- `package.json` (workspace scripts & devDependencies) +- `pnpm-workspace.yaml` (workspace package list) +- `nx.json` (Nx configuration) +- `typedoc.json` (documentation build) -- pnpm (workspace) - declared in root `package.json` (`packageManager: "pnpm@10.30.3"`) and used throughout scripts and CI. Lockfile: `pnpm-lock.yaml` present at repo root (workspace lockfile). +Developer workflow notes -## Frameworks & Monorepo Tools +- Use `pnpm i` to install and `pnpm run build` to build the full workspace. +- Many package-level tasks are exposed via Nx; prefer `pnpm exec nx` or `npx nx` for targeted actions. -- Nx - monorepo orchestration and affected builds. See `nx.json` and many `package.json` scripts that call `nx` (`package.json` root scripts: `slimbuild`, `build:ci`, etc.). `nx-cloud` is configured and used for distributed execution (`nx.json`, `devDependencies.nx`, `devDependencies.nx-cloud`). -- Lerna - used for publishing packages (see root `package.json` `scripts.version:*` and `scripts.publish:*`, and `.github/workflows/npm-publish.yml` which runs `npx lerna publish from-package`). -- tsparticles-cli - custom build/publish tooling used by packages. Many package `scripts` call `tsparticles-cli build` (examples: `bundles/all/package.json` `scripts.build`, `engine/package.json` `scripts.build`). +Where to look for tech-specific code -## Build & Bundling +- Build/bundle configs: `bundles/*/webpack.config.js` +- Typedoc config: `typedoc.json` +- Workspace scripts: `package.json` (root) -- Webpack 5 - bundling for browser bundles. There are many `webpack.config.js` files spread across `bundles/*` and package subfolders (examples: `bundles/all/webpack.config.js`, `engine/webpack.config.js`, and many `*/webpack.config.js` under `shapes/`, `plugins/`, `paths/`). -- swc (via `@swc/core` and `swc-loader`) is present for faster compilation and transforms (`devDependencies` in root `package.json`). -- TypeDoc - API documentation generation (`package.json` root scripts: `build:docs`, `build:docs:json`). See `typedoc` usage in root and packages (`devDependencies.typedoc`). -- ts-json-schema-generator / ts-json-schema-generator-like tooling used in `engine/package.json` to generate JSON schema (`scripts.build:schema`). +Recommendations / quick wins -## Testing & QA - -- Vitest - test runner (`devDependencies.vitest`, `@vitest/ui`). Tests and test tooling are mentioned in `AGENTS.md` and devDependencies; workspace test commands documented in `AGENTS.md`. -- jsdom & canvas - runtime shims for DOM and canvas in tests (`devDependencies.jsdom`, `canvas`). See `utils/tests` referenced in `AGENTS.md` and `devDependencies` in root `package.json`. -- ESLint & Prettier - linting and formatting enforced. Root `package.json` references `@tsparticles/eslint-config` and `@tsparticles/prettier-config`. Husky + commitlint for commit message rules (`devDependencies.husky`, `@commitlint/*`). - -## Key Dependencies (representative) - -**Workspace / monorepo tooling:** - -- `nx` (`devDependencies` in root `package.json`) - task orchestration. Files: `nx.json`. -- `nx-cloud` - remote caching and distributed execution (see `nx.json` `tasksRunnerOptions.runner` and CI env `NX_CLOUD_ACCESS_TOKEN` in `.github/workflows`). -- `lerna` - publishing orchestration (`package.json` root scripts and publish workflow). Files: root `package.json` and `.github/workflows/npm-publish.yml`. - -**Build / transpilation:** - -- `typescript` (root `devDependencies`) - source language. Configs: multiple `tsconfig*.json` across packages (e.g. `tsconfig.json` at repo root and per-package configs under `*/tsconfig.*.json`). -- `webpack` + `webpack-cli` + `terser-webpack-plugin` - bundling and minification. See `bundles/*/webpack.config.js` and `engine/webpack.config.js`. -- `@swc/core` + `swc-loader` - optional fast transforms in build pipeline (root `devDependencies`). - -**Testing:** - -- `vitest`, `@vitest/ui` - unit tests (`devDependencies`). -- `jsdom`, `canvas` - test environment support for DOM/canvas tests (`devDependencies`). - -**Utilities & tooling:** - -- `typedoc` and a number of typedoc plugins for docs generation (root `devDependencies` and `build:docs` script). -- `gh-pages` - for legacy docs/website publishing (present in root `devDependencies`). -- `rimraf`, `fs-extra`, `copyfiles` - build helpers. - -## Dev / Local Workflow (how to build) - -Recommended quick-start (documented in `README.md`): - -1. Install workspace deps: `pnpm i` (root `package.json` uses `pnpm`). - - See root `package.json` and `AGENTS.md` for workspace-aware commands; prefer `pnpm` + `nx` patterns. - -2. Build everything locally (slim/full flow): - - `pnpm run build` runs root script which calls `pnpm run slimbuild` and then `pnpm run build:docs` (see `package.json` root `scripts`). - - `pnpm run slimbuild` runs `nx run-many -t build --parallel=50%` after README prettification. For CI a stricter path is `pnpm run slimbuild:ci` / `pnpm run build:ci`. - -3. Build a single package or affected packages with Nx: - - `npx nx build ` or `npx nx affected -t build` (see `nx.json` and CI usage in `.github/workflows/nodejs.yml`). - -4. Demo server (example): - - `cd demo/vanilla && pnpm start` — demo server startup (see `demo/vanilla/package.json` `scripts.start`). - -5. Publishing: - - Publishing is automated through `.github/workflows/npm-publish.yml` that uses Node 24 and OIDC to publish via `lerna`. Locally, `pnpm run publish:...` helper scripts exist in root `package.json` (alpha/beta/next/dist tags). - -## Notable file references - -- Root package manifest: `package.json` (workspace scripts, devDependencies, `packageManager: pnpm@...`). -- Monorepo orchestration: `nx.json` (Nx + nx-cloud settings). -- Per-package build scripts: `engine/package.json`, `bundles/*/package.json`, many `*/webpack.config.js` files (examples: `bundles/all/webpack.config.js`, `engine/webpack.config.js`). -- Demo server: `demo/vanilla/package.json` (express-based demo server) and `demo/electron/package.json`. -- CI: `.github/workflows/nodejs.yml`, `.github/workflows/npm-publish.yml`, `.github/workflows/docs.yml`. - ---- - -_Stack analysis: 2026-03-03_ +- Check Node and pnpm versions in CI to match `packageManager` and devDependency compatibility. +- Add explicit node engine constraint if consistent Node version is required for contributors. diff --git a/.planning/codebase/STRUCTURE.md b/.planning/codebase/STRUCTURE.md index 828ffb73d47..b63059858e9 100644 --- a/.planning/codebase/STRUCTURE.md +++ b/.planning/codebase/STRUCTURE.md @@ -1,135 +1,38 @@ -# Codebase Structure +# STRUCTURE -**Analysis Date:** 2026-03-03 +Top-level layout -## Directory Layout (top-level) +- `engine/` — Core runtime and exports (`engine/src/`) +- `plugins/` — Plugins (e.g., `plugins/themes/src/`) +- `paths/` — Path generators (e.g., `paths/grid/src/`) +- `utils/` — Utilities and small libraries (e.g., `utils/perlinNoise/src/`) +- `bundles/` — Build targets and webpack configs for distribution +- `markdown/` — Developer and docs markdown -``` -[project-root]/ -├── engine/ # Core runtime and public API (TypeScript source) -├── bundles/ # Prebuilt bundles that aggregate sets of plugins -├── demo/ # Demo applications (vanilla, electron) -├── updaters/ # Particle updaters (per-feature packages) -├── interactions/ # Interaction packages (external & particles) -├── shapes/ # Shape drawers (circle, polygon, emoji, image...) -├── plugins/ # Plugins (interactivity, emitters, etc.) -├── utils/ # Small utility libraries (noise, fields, etc.) -├── .planning/ # Planning docs and phases (this repo) -├── package.json # Workspace scripts and devDependencies -├── pnpm-workspace.yaml # pnpm workspace config -├── nx.json # Nx configuration -└── README.md -``` +Notable files -## Key directories and purposes +- `package.json` (root) — workspace scripts, devDeps +- `pnpm-workspace.yaml` — workspace package globs +- `nx.json` — Nx configuration for tasks +- `typedoc.json` — typedoc configuration -engine/ +Directory conventions -- Purpose: core runtime implementation and public API surface. -- Contains: `src/` with core classes, `package.json`, `typedoc.json`, `scripts/`. -- Key files: - - `engine/src/index.ts` — library entrypoint, sets `globalThis.tsParticles`. - - `engine/src/initEngine.ts` — Engine initializer. - - `engine/src/exports.ts` and `engine/src/export-types.ts` — public exports. - - `engine/src/Core/Engine.ts`, `engine/src/Core/Container.ts` — main runtime classes. +- Each package follows `src/` layout with TypeScript sources and package-specific `tsconfig.*.json`. +- Bundles use `tsconfig.browser.json` when building browser-specific bundles. -bundles/ +Naming & file conventions -- Purpose: produce browser-ready bundles that include engine + commonly-used plugins. -- Pattern: each bundle has `src/` for a loader (e.g. `bundles/slim/src/index.ts`), `webpack.config.js` and `dist/` with generated artifacts. -- Example paths: `bundles/slim/src/index.ts`, `bundles/slim/dist/tsparticles.slim.bundle.js`. +- PascalCase for classes and types (e.g., `GridPathGenerator.ts` exports `GridPathGenerator`). +- Use `index.ts` for package/module public entry points (`engine/src/index.ts`). -updaters/, interactions/, shapes/ +Where to look for runtime vs build code -- Purpose: broken-down feature packages that each expose a loader function. -- Structure: `updaters//src/`, `interactions/external//src/`, `shapes//src/`. -- Example files: - - `updaters/size/src/SizeUpdater.ts` - - `interactions/external/bounce/src/Bouncer.ts` - - `shapes/rounded-polygon/src/RoundedPolygonDrawer.ts` +- Runtime code: `engine/src/`, `plugins/*/src/`, `paths/*/src/`, `utils/*/src/` +- Build/tooling: `bundles/*/`, `typedoc.json`, root `package.json` scripts -utils/ +Quick navigation pointers -- Purpose: small libraries usable by engine and external projects. -- Layout: `utils//src/` and `utils//dist/` after build. -- Example: `utils/perlinNoise/src/PerlinNoise.ts`, `utils/noiseField/dist/` bundles. - -demo/ - -- Purpose: example apps that run the built packages and host sample pages. -- Important files: `demo/vanilla/app.ts` (Express server), `demo/vanilla/views/*.pug`, `demo/vanilla/public/javascripts/*.js`. - -.planning/ - -- Purpose: planning and phase documents used by this repo's process. -- Contains: `.planning/phases/*` and the files this mapping writes (`.planning/codebase/ARCHITECTURE.md`, `.planning/codebase/STRUCTURE.md`). - -Other top-level files - -- `package.json` — workspace scripts and central devDependencies (run with pnpm). -- `pnpm-workspace.yaml` — list of workspace packages. -- `nx.json` — Nx monorepo configuration. - -## Example file map (notable files) - -- `engine/src/Core/Engine.ts` — engine registry, plugin and preset management. -- `engine/src/Core/Container.ts` — container lifecycle, animation loop, plugin orchestration. -- `engine/src/Core/Canvas.ts` — canvas drawing and background handling. -- `engine/src/Utils/EventDispatcher.ts` — event pub/sub used by engine and containers. -- `bundles/slim/src/index.ts` — bundle loader that imports many packages and registers them. -- `bundles/slim/dist/tsparticles.slim.bundle.js` — prebuilt bundle for browser consumption. -- `updaters/size/src/SizeUpdater.ts` — an example updater implementation. -- `interactions/external/bounce/src/Bouncer.ts` — example external interaction. -- `shapes/rounded-polygon/src/RoundedPolygonDrawer.ts` — example shape drawer. -- `utils/perlinNoise/src/PerlinNoise.ts` — utility noise generator. -- `demo/vanilla/app.ts` — demo server mounting many built packages under static routes. - -## Where to find sources vs build outputs - -- Sources: every package contains `src/` with TypeScript source files. Examples: - - `engine/src/*.ts`, `updaters/*/src/*.ts`, `shapes/*/src/*.ts`, `utils/*/src/*.ts`. -- Build outputs: packages that produce a distribution place compiled artifacts in `dist/` (UMD/CJS/ESM). Examples: - - `bundles/slim/dist/` (many `.js` files and `tsparticles.slim.bundle.js`) - - `utils/perlinNoise/dist/` contains `tsparticles.perlin.noise.js` and module builds. - -## Tests and fixtures - -- Tests live under specialized packages (see `utils/tests/` referenced in AGENTS.md). Search `*.test.*` or vitest project configs per package. -- The repo uses Vitest as test runner. Top-level devDependencies include `vitest` (see root `package.json` lines ~80). - -## Docs and typedoc - -- Each package may include `typedoc.json` (e.g. `engine/typedoc.json`, `bundles/slim/typedoc.json`). -- Root `package.json` scripts include `build:docs` → `typedoc` which generates docs from engine and packages. - -## Naming & placement guidance (where to add new code) - -New engine-level features - -- Add to: `engine/src/` (Core classes go in `engine/src/Core/`, reusable utils to `engine/src/Utils/`). -- Tests: add package-local tests under an appropriate `tests/` folder inside `engine` or follow existing test conventions (see `utils/tests/` for patterns). - -New plugin/shape/updater - -- Create a new package under `updaters/`, `shapes/`, or `interactions/` with `package.json`, `src/`, and `typedoc.json`. -- Export a loader function named `load` which accepts `engine: Engine` and registers the feature. -- Example: `updaters/my-updater/src/index.ts` exporting `export async function loadMyUpdater(engine: Engine) { /* register */ }`. - -New bundle - -- Add a `bundles//src/index.ts` loader that dynamically imports packages and calls their loader functions, following the pattern in `bundles/slim/src/index.ts`. -- Add `webpack.config.js`, `typedoc.json`, and `package.json` for packaging. - -Utilities & shared code - -- Put generic helpers into `utils//src/` and expose minimal public APIs. - -## File & naming conventions (observed patterns) - -- TypeScript source files use PascalCase for classes and matching filenames (e.g. `Container.ts` exports `Container`). -- Loader functions follow `loadXxx` naming (e.g. `loadSlim`, `loadExternalBounceInteraction`). -- Packages follow standard npm layout with `src/`, `dist/`, `package.json` and `package.dist.json` when publishing. - ---- - -_Structure analysis: 2026-03-03_ +- Start at `engine/src/index.ts` to understand the runtime API surface. +- Explore `plugins/themes/src/` to see how plugins register with the engine. +- Check `bundles/slim/src/` for how bundles are assembled. diff --git a/.planning/codebase/TESTING.md b/.planning/codebase/TESTING.md index 927f3ea1fc9..74e3ed93dfe 100644 --- a/.planning/codebase/TESTING.md +++ b/.planning/codebase/TESTING.md @@ -1,103 +1,29 @@ -# Testing Patterns +# TESTING -**Analysis Date:** 2026-03-03 +Test framework & setup -This document captures the repository's testing framework, test layout, fixture patterns, and commands to run tests locally and in CI. All references point to concrete files so automation and human contributors can run tests and follow existing patterns. +- Vitest is used as the test runner (`vitest` devDependency). +- Tests use jsdom for DOM/canvas-related tests (`jsdom`, `@types/jsdom`). -1. Test framework and config +Where tests live -- Test runner: Vitest (workspace devDependency declared in root `/package.json`, line ~80). Many packages use vitest; the primary test package is `utils/tests` which contains `vitest.config.ts` at `utils/tests/vitest.config.ts`. -- `utils/tests/vitest.config.ts` (path: `utils/tests/vitest.config.ts`) configures: - - include: `src/tests/*.ts` - - environment: `jsdom` - - maxWorkers: 1 - - coverage provider: `v8` and coverage enabled (see lines 4-11). +- Primary test utilities and fixtures: `utils/tests/` (look for fixtures under `utils/tests/src/Fixture/`). -2. Test package layout +Running tests -- Primary test package: `utils/tests/` (path: `utils/tests/`) - - `utils/tests/src/tests/` — test files (e.g. `Particle.ts`, `Utils.ts`, `deepExtend.test.ts`, `memoize.test.ts`). - - `utils/tests/src/Fixture/` — fixtures used by tests (e.g. `Window.ts`, `CustomCanvas.ts`, `Utils.ts`). - - `utils/tests/vitest.config.ts` — vitest configuration for this package. - - `utils/tests/package.json` — package scripts for running tests and linting. +- Run all tests: `pnpm exec vitest` or `npx nx run-many -t test`. +- Run package tests: `pnpm --filter @tsparticles/tests test` (package-specific scripts may exist). +- Run a single test file: `pnpm exec vitest run path/to/test/file.ts` or use Nx `npx nx test --testFile=src/tests/Particle.ts`. -3. Test file naming & organization +Coverage -- Two patterns coexist: - - Co-located tests following `*.test.ts` naming (examples: `utils/tests/src/tests/deepExtend.test.ts`, `memoize.test.ts`). - - Package-level test files under `src/tests/*.ts` that are imported by the package vitest config (see `vitest.config.ts` include pattern). -- Tests use ES module imports and named imports. Examples: - - `import { describe, expect, it } from "vitest";` (`utils/tests/src/tests/deepExtend.test.ts`) - - `import { memoize } from "@tsparticles/engine";` (`utils/tests/src/tests/memoize.test.ts`) +- Vitest configured with v8 provider and coverage is emitted under `utils/tests/coverage/` in CI. -4. Test scripts and commands +Testing practices -- Package scripts (see `utils/tests/package.json`): - - `pnpm --filter @tsparticles/tests run test` → runs `vitest run` (non-watch) - - `pnpm --filter @tsparticles/tests run test:ui` → `vitest watch --ui` (UI watch mode) - - `pnpm --filter @tsparticles/tests run test:particle` → runs a single test file `src/tests/Particle.ts` (convenience script) - - `pnpm --filter @tsparticles/tests run test:ci` → `NODE_ENV=test vitest run --maxConcurrency=2` (CI tuned) -- Workspace-level commands (see `AGENTS.md`): - - Run all tests: `pnpm exec vitest` or `npx nx run-many -t test` - - Run one package tests: `pnpm --filter @tsparticles/tests test` - - Run a single test file directly: `pnpm exec vitest run path/to/test/file.ts` (e.g. `utils/tests/src/tests/Particle.ts`). +- Keep tests deterministic; avoid timing-based assertions and use mocked timers or manual ticks. +- Canvas tests run in Node in CI via `canvas` library. -5. Fixtures & deterministic testing +Quick checks -- DOM/jsdom fixture: `utils/tests/src/Fixture/Window.ts` exposes a `TestWindow` using `new JSDOM("").window` for deterministic DOM. -- Canvas fixture: `utils/tests/src/tests/fixtures/canvas-fixtures.ts` provides `createDeterministicCanvas`, `setupCanvasFixtures`, and `teardownCanvasFixtures`. Characteristics: - - Seedable RNG (`makeRng(seed)`), default seed 1337. - - Sets `globalThis.devicePixelRatio` in a guarded way for deterministic rendering (see lines ~58-66 and ~129-139). - - Prefers `OffscreenCanvas` when available; falls back to `HTMLCanvasElement` (lines 46-56). - - Provides `clear(color)` utility to reset canvas (lines 71-82). -- Tests rely on deterministic inputs and avoid timing-based assertions; prefer explicit ticks or mocked timers when needed (documented in `AGENTS.md`). - -6. Coverage - -- Coverage is collected using Vitest's `v8` provider. Configured in `utils/tests/vitest.config.ts` (coverage.provider = "v8", enabled: true). -- Coverage artifacts are generated under `utils/tests/coverage/` in CI and in local runs. The repository includes sample coverage outputs in `utils/tests/coverage/` (e.g. `index.html`, `coverage-final.json`). - -7. Mocking & isolation patterns - -- Tests import small fixture helpers rather than global mocks. Example patterns: - - Use `setupCanvasFixtures()` and `teardownCanvasFixtures()` from `utils/tests/src/tests/fixtures/canvas-fixtures.ts` to create and remove DOM canvas elements. - - Use `TestWindow` from `utils/tests/src/Fixture/Window.ts` when a JSDOM window is required by a helper. -- Prefer per-test setup/teardown (Vitest `beforeEach`/`afterEach`) and avoid global state mutation when possible. Canvas fixture demonstrates guarded global writes and best-effort cleanup. - -8. Running tests locally (recommended commands) - -- Run tests for the `utils/tests` package (fast path): - - pnpm --filter @tsparticles/tests run test - - pnpm --filter @tsparticles/tests run test:ui -- Run a single test file directly from the repo root: - - pnpm exec vitest run utils/tests/src/tests/Particle.ts -- Run the full workspace tests (may be heavy): - - pnpm exec vitest - - or npx nx run-many -t test -- For CI-like execution with environment settings (mimics package script): - - NODE_ENV=test pnpm exec vitest run --maxConcurrency=2 - -9. Lint + tests in CI pipeline - -- Packages define combined scripts that run lint + prettify + tests. Example in `utils/tests/package.json`: - - `build:ci` → `pnpm run lint:ci && pnpm run prettify:ci && pnpm run test:ci` (line 12). -- Recommended pre-PR local run: `pnpm --filter @tsparticles/tests run build` will run lint, prettify, and tests for the package (see `utils/tests/package.json` line 10). - -10. Guidelines for adding new tests - -- Place unit tests with the code they test when possible; otherwise add test files under `utils/tests/src/tests/` if they depend on engine internals or shared fixtures. -- Use existing fixtures: import `createDeterministicCanvas` or `TestWindow` rather than creating ad-hoc DOM mocks. -- Name tests clearly and keep them deterministic; prefer small, focused tests with explicit setup and teardown. - -References (concrete files): - -- Runner & deps: `/package.json` (Vitest in devDependencies) -- Main test package: `utils/tests/package.json` -- Vitest config: `utils/tests/vitest.config.ts` -- Fixtures: `utils/tests/src/Fixture/Window.ts`, `utils/tests/src/tests/fixtures/canvas-fixtures.ts` -- Example tests: `utils/tests/src/tests/deepExtend.test.ts`, `utils/tests/src/tests/memoize.test.ts` -- Coverage artifacts: `utils/tests/coverage/` (contains `index.html`, `coverage-final.json`, and per-file HTML reports) - ---- - -_Testing analysis: 2026-03-03_ +- To run a single particle test: `pnpm --filter @tsparticles/tests test:particle` (where available). diff --git a/.planning/config.json b/.planning/config.json index 3aec130bcdb..cb1826170ee 100644 --- a/.planning/config.json +++ b/.planning/config.json @@ -3,7 +3,7 @@ "depth": "standard", "parallelization": true, "commit_docs": true, - "model_profile": "budget", + "model_profile": "balanced", "workflow": { "research": true, "plan_check": true, diff --git a/.planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md deleted file mode 100644 index 6577800c39e..00000000000 --- a/.planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 01 -subsystem: testing/utils -tags: [memoize, deepExtend, vitest, jsdom, fixtures] - -# Dependency graph -requires: - - phase: 01-core-stabilization/03 - provides: "Deterministic canvas fixtures for jsdom tests" -provides: - - "Unit-tested core utilities: memoize and deepExtend" - -# Tech tracking -tech-stack: - added: [] - patterns: ["TDD (RED → GREEN)", "Deterministic jsdom fixtures for canvas"] - -key-files: - created: [] - modified: - - utils/tests/src/tests/Memoize.test.ts - - utils/tests/src/tests/DeepExtend.test.ts - - utils/tests/src/Fixture/CanvasFixture.ts - - engine/src/Utils/memoize.ts - - engine/src/Utils/deepExtend.ts - -key-decisions: - - "None - followed plan as specified" - -patterns-established: - - "TDD for core utilities: write failing tests first, implement minimal fix, refactor if needed" - -requirements-completed: [CORE-01, TEST-01] - -# Metrics -duration: 1min -completed: 2026-03-03 ---- - -# Phase 01-core-stabilization: Plan 01 Summary - -**Unit-tested and hardened memoize and deepExtend utilities with deterministic jsdom canvas support for tests.** - -## Performance - -- **Duration:** 1 min -- **Started:** 2026-03-03T11:20:46Z -- **Completed:** 2026-03-03T11:21:30Z -- **Tasks:** 3 -- **Files modified:** 5 - -## Accomplishments - -- Added/validated Vitest tests for memoize and deepExtend covering caching behavior, ttl/maxSize, deep merging, array handling, and prototype-pollution protections. -- Implemented/verified memoize and deepExtend fixes so tests pass locally. -- Ensured deterministic canvas fixtures are available for jsdom-based tests (fixture existed and was reused). - -## Task Commits - -Each task was committed atomically: - -1. **Task 1: TDD — Add failing tests for memoize and deepExtend (RED)** - `014d03f` (test) -2. **Task 2: TDD — Implement minimal fixes to pass tests (GREEN)** - `b6185092` (feat) -3. **Task 3: Add deterministic canvas fixture for jsdom tests** - `577b66d0` (feat, added earlier and reused) - -**Plan metadata:** `$(git rev-parse --short HEAD)` (docs: complete plan) - -## Files Created/Modified - -- `utils/tests/src/tests/Memoize.test.ts` - Vitest tests for memoize behavior (cache, ttl, maxSize) -- `utils/tests/src/tests/DeepExtend.test.ts` - Vitest tests for deepExtend edge cases (arrays, nulls, prototype pollution) -- `engine/src/Utils/memoize.ts` - Bounded memoize implementation with options (maxSize, ttlMs, keyFn) -- `engine/src/Utils/deepExtend.ts` - deepExtend hardened to avoid prototype pollution and handle null/undefined -- `utils/tests/src/Fixture/CanvasFixture.ts` - Deterministic canvas fixture helpers (reused from fixtures plan) - -## Decisions Made - -None - followed plan as specified. - -## Deviations from Plan - -None required. The deterministic canvas fixture needed by Task 3 was already present (added in a separate fixtures plan) and was reused here; no new fixture changes were necessary. - -## Issues Encountered - -None — tests passed locally when executed. - -## User Setup Required - -None - no external service configuration required. - -## Next Phase Readiness - -- Core utilities stabilized and covered by tests; ready for downstream feature work and CI wiring (CI wiring handled in separate plan). - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-03_ diff --git a/.planning/phases/01-core-stabilization/01-PLAN.md b/.planning/phases/01-core-stabilization/01-PLAN.md deleted file mode 100644 index 5fa956a3add..00000000000 --- a/.planning/phases/01-core-stabilization/01-PLAN.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 01 -type: execute -wave: 1 -depends_on: [] -files_modified: - - utils/tests/src/tests/Memoize.test.ts - - utils/tests/src/tests/DeepExtend.test.ts - - utils/tests/src/Fixture/CanvasFixture.ts - - engine/src/Utils/memoize.ts - - engine/src/Utils/deepExtend.ts -autonomous: true -requirements: [CORE-01, TEST-01] -user_setup: [] -must_haves: - truths: - - "Unit tests covering core utilities (memoize, deepExtend) exist and pass locally" - - "Deterministic canvas fixtures are available for jsdom-based tests" - - "CI will run the same tests (CI wiring in separate plan)" - artifacts: - - path: "utils/tests/src/tests/Memoize.test.ts" - provides: "Behavioral tests for memoize: cache hits, ttl, maxSize" - - path: "utils/tests/src/tests/DeepExtend.test.ts" - provides: "Tests for deepExtend merging behavior and edge-cases" - - path: "utils/tests/src/Fixture/CanvasFixture.ts" - provides: "Deterministic canvas fixture helpers used by engine tests" - key_links: - - from: "utils/tests/src/tests/*.test.ts" - to: "engine/src/Utils/*" - via: "import { memoize } from 'engine/src/Utils/memoize'" - pattern: "memoize\(|deepExtend\(" - ---- - - -Stabilize core utility behavior with TDD and reliable fixtures so downstream work has a trustworthy foundation. - -Purpose: Ensure core helpers (memoize, deepExtend) behave correctly under edge cases and are covered by deterministic tests. -Output: Tests (utils/tests/src/tests/_) and small fixes in engine/src/Utils/_; deterministic canvas fixture helper. - - - -@.planning/PROJECT.md -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md - - - -Phase: Core Stabilization — Goal: Ensure core runtime is correct and covered by tests (ROADMAP.md) - -Use these existing artifacts as references: -@engine/src/ -@utils/tests/ - - - - - - Task 1: TDD — Add failing tests for memoize and deepExtend (RED) - utils/tests/src/tests/Memoize.test.ts, utils/tests/src/tests/DeepExtend.test.ts - - - Test 1: memoize caches results; repeated calls with same args call original function once - - Test 2: memoize respects maxSize by evicting old entries - - Test 3: memoize respects ttlMs (entry expires after ttl) - - Test 4: deepExtend merges nested objects without mutating inputs - - Test 5: deepExtend handles arrays, nulls, and undefined safely - - - Create new Vitest test files at the listed paths that assert the behaviors above (start RED — tests may fail until implementation changes). Use existing test utilities and import paths used by the repo (prefer absolute package imports if present). Keep tests focused and deterministic (avoid timers where possible; use mocked timers for ttl checks). - After adding tests, run the tests to observe failures. Commit the test files as the RED step. - - - pnpm exec vitest run utils/tests/src/tests/Memoize.test.ts utils/tests/src/tests/DeepExtend.test.ts - - Both test files exist and run (may fail initially). Automated command returns non-zero when RED. Files committed. - - - - Task 2: TDD — Implement minimal fixes to pass tests (GREEN) - engine/src/Utils/memoize.ts, engine/src/Utils/deepExtend.ts - - - After implementation, all tests from Task 1 pass - - memoize exposes options: { maxSize?: number, ttlMs?: number, keyFn?: Function } - - deepExtend preserves input immutability and merges correctly - - - Modify the implementations in the listed files to satisfy tests. Follow project conventions (explicit types, named exports). Keep changes minimal: prefer patching edge cases exposed by tests rather than full rewrites. Run unit tests locally until green. Commit implementation changes with Conventional Commit message: `feat(01-core-stabilization-01): fix memoize/deepExtend to satisfy tests`. - - - pnpm exec vitest run utils/tests/src/tests/Memoize.test.ts utils/tests/src/tests/DeepExtend.test.ts --run - - All tests from Task 1 pass locally (exit 0). Commits created for implementation changes. - - - - Task 3: Add deterministic canvas fixture for jsdom tests - utils/tests/src/Fixture/CanvasFixture.ts, utils/tests/vitest.config.ts - - Create `CanvasFixture.ts` exporting helpers to create deterministic canvas elements usable in jsdom-based tests (width/height, deterministic 2D context stubs). Update `utils/tests/vitest.config.ts` (or `vitest` config file used in repo) to register fixture globals if needed. Ensure fixture is documented in top of test files. - - - pnpm exec vitest run utils/tests/src/tests/DeepExtend.test.ts --run - - Fixture file exists, tests relying on canvas fixtures pass locally. Config updated and committed. - - - - - -After implementing tasks, run the full affected test set: - -Automated: `pnpm exec vitest --run utils/tests/src/tests/Memoize.test.ts utils/tests/src/tests/DeepExtend.test.ts` - -If tests fail in CI only, surface CI logs for diagnosis. Otherwise tests must pass locally. - - - - -- Unit tests for memoize and deepExtend added and passing locally -- Deterministic canvas fixture created and used by tests -- Commits created for tests and implementation changes -- Requirements covered: CORE-01, TEST-01 - - - -After completion, create `.planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/01-UAT.md b/.planning/phases/01-core-stabilization/01-UAT.md deleted file mode 100644 index 3f5f7006d6b..00000000000 --- a/.planning/phases/01-core-stabilization/01-UAT.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -status: complete -phase: 01-core-stabilization -source: [01-core-01-SUMMARY.md, 01-core-02-SUMMARY.md, 01-core-03-SUMMARY.md] -started: 2026-03-01T20:40:00Z -updated: 2026-03-01T20:55:00Z ---- - -## Current Test - -[testing complete] - -## Tests - -### 1. Run memoize unit tests - -expected: Run the memoize test file; it passes locally (see command above) -result: pass - -### 2. Run deepExtend unit tests - -expected: Run the deepExtend test file: pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/deepExtend.test.ts" — nested merges and prototype-protection assertions pass -result: pass - -### 3. Run CI-like utils test:ci - -expected: Run pnpm --filter @tsparticles/tests run test:ci (or in CI). Expected: test:ci completes and no intermittent failures related to canvas fixtures observed in a few repeated runs or in CI history -result: pass - -## Summary - -total: 3 -passed: 3 -issues: 0 -pending: 0 -skipped: 0 - -## Gaps - -[none yet] diff --git a/.planning/phases/01-core-stabilization/01-VERIFICATION.md b/.planning/phases/01-core-stabilization/01-VERIFICATION.md deleted file mode 100644 index 86fb42ccdc9..00000000000 --- a/.planning/phases/01-core-stabilization/01-VERIFICATION.md +++ /dev/null @@ -1,214 +0,0 @@ ---- -phase: 01-core-stabilization -verified: 2026-03-03T12:00:00Z -status: gaps_found -score: 9/13 -re_verification: false -gaps: - - truth: "Plans and changes are verified by plan-checker and pass must-have checks" - status: failed - reason: "plan-checker output contains an error: 'No frontmatter detected' for 05-PLAN.md (VERIFICATION.md records this). The checker ran but reported an issue; human approval was recorded but the frontmatter/parsing problem remains." - artifacts: - - path: ".planning/phases/01-core-stabilization/VERIFICATION.md" - issue: "Contains 'ERROR: No frontmatter detected' for 05-PLAN.md" - - path: ".planning/phases/01-core-stabilization/05-PLAN.md" - issue: "Verify YAML frontmatter formatting (checker reported missing frontmatter)." - missing: - - "Re-run plan-checker after fixing 05-PLAN.md frontmatter; ensure VERIFICATION.md shows PASS or records follow-up issues." - - - truth: "All phase artifacts committed and a phase summary exists" - status: failed - reason: "STATE.md records several files as created but uncommitted due to a git ref lock; these must be committed to satisfy the must-have 'committed artifacts'." - artifacts: - - path: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - issue: "Created but may be uncommitted (STATE.md notes uncommitted files)." - - path: ".planning/phases/01-core-stabilization/CORE-02-AUDIT.md" - issue: "Created but may be uncommitted (STATE.md notes uncommitted files)." - - path: ".planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md" - issue: "Created but may be uncommitted (STATE.md notes uncommitted files)." - missing: - - "Run git add/commit as suggested in .planning/STATE.md to finalize these artifacts." - - - truth: "CI will run the same tests (CI wiring in separate plan)" - status: partial - reason: "CI configuration includes a bundle-size test job (nodejs.yml) but there is no explicit, single CI step observed that runs the utils/tests test:ci across all workflows. The plan claimed CI would run the same tests; wiring is partial." - artifacts: - - path: ".github/workflows/nodejs.yml" - issue: "Contains 'Run bundle size check' step that runs BundleSize.test.ts; does not explicitly run @tsparticles/tests test:ci for unit test suites." - missing: - - "Add/confirm CI job that runs: pnpm --filter @tsparticles/tests run test:ci (or include utils tests in affected tasks) so unit tests are enforced in CI." - - - truth: "Bundle build step runs deterministically in CI" - status: partial - reason: "Webpack bundle configs exist and the bundle-size test runs in CI, but determinism must be validated by repeated CI runs or controlled local reproduction." - artifacts: - - path: "bundles/*/webpack.config.js" - issue: "Present for all bundles; provides deterministic build options but determinism is a runtime property." - missing: - - "Run CI job multiple times or create a small reproducible job to assert deterministic outputs; if flaky, harden webpack configs or test harness." - -human_verification: - - test: "Run unit tests for utils package (memoize & deepExtend)" - expected: "All utils tests pass locally: pnpm --filter @tsparticles/tests test -- 'utils/tests/src/tests/memoize.test.ts' and 'utils/tests/src/tests/deepExtend.test.ts' (exit 0)." - why_human: "This environment cannot execute the workspace test runner; runtime verification requires running tests locally or in CI." - - - test: "Run CI job(s) to validate test:ci and bundle size enforcement" - expected: "CI job(s) execute and pass; bundle size test fails on regression; unit tests run and demonstrate stable behavior across repeated runs." - why_human: "CI runs and flakiness measurements require actual pipeline executions and environment-specific validation." - -next_steps: - - 'Fix 05-PLAN.md frontmatter if malformed; re-run plan-checker to clear ''No frontmatter detected'' and regenerate VERIFICATION.md. Use: node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" plan-check .planning/phases/01-core-stabilization' - - "Commit the uncommitted research/audit/summary files listed in .planning/STATE.md (git add + git commit) and re-run the plan-checker. See .planning/STATE.md for suggested git commands." - - "Add/confirm CI step to run utils/tests test:ci (pnpm --filter @tsparticles/tests run test:ci) or include utils tests in the affected test set so unit tests are enforced in CI." - - "Run CI (or local) test:ci multiple times to confirm determinism and flakiness reduction; if flaky, add retries or harden fixtures." - - 'After gaps are closed, re-run this verifier or run: node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" phase complete "01-core-stabilization" (or run local manual completion steps if gsd-tools missing).' ---- - -# Phase 01: Core Stabilization — Verification Report - -Phase Goal: Ensure core runtime is correct and covered by tests. - -Verified: 2026-03-03T12:00:00Z -Status: gaps_found - -Summary - -- Plans inspected: .planning/phases/01-core-stabilization/\*-PLAN.md -- Total must-haves (truths) collected from plan frontmatter: 13 -- Verified (artifacts & wiring present): 9 -- Partial / needs runtime validation: 2 -- Failed (missing/uncommitted/wiring broken): 2 - -Score: 9/13 must-haves verified at artifact & wiring level - -Gaps Summary (high level) - -- Plan-checker reported a parsing/frontmatter error for 05-PLAN.md which left the plan-check step with an issue recorded in VERIFICATION.md. Human approval was recorded but the parsing issue remains and must be fixed. -- Several planning artifacts were created but not committed due to a git ref-lock in this environment (STATE.md documents the files and suggests git commands). These files must be committed so the phase artifacts are durable and discoverable. -- CI partly enforces bundle-size checks (verified), but the plan claim that CI runs the full utils tests is not fully wired — add/confirm CI steps to run utils/tests test:ci to enforce unit tests in CI. -- Determinism of bundle builds and fixture stability cannot be asserted from static code alone; run CI or repeated local runs to confirm. - -Required Artifacts Verified (examples) - -- engine/src/Utils/Utils.ts — memoize + deepExtend implementations — VERIFIED -- utils/tests/src/tests/memoize.test.ts — test file exists and imports memoize — VERIFIED -- utils/tests/src/tests/deepExtend.test.ts — test file exists and imports deepExtend — VERIFIED -- utils/tests/src/Fixture/CustomCanvas.ts, Window.ts — deterministic jsdom/canvas helpers — VERIFIED -- bundles/\*/webpack.config.js — bundle configs present for all bundles — VERIFIED -- utils/tests/package.json — contains test:ci script — VERIFIED - -Key Links Verified - -- tests -> engine utils imports (WIRED) -- bundle size test -> CI workflow (WIRED) - -Human Verification Required - -- Run the utils tests locally and/or in CI and confirm they pass consistently: pnpm --filter @tsparticles/tests run test:ci -- Re-run plan-checker after fixing frontmatter/parsing issues and ensure VERIFICATION.md no longer reports parsing errors. - -Next Steps - -- Fix 05-PLAN.md frontmatter, commit it, re-run plan-checker. -- Commit uncommitted research/audit/summary files as suggested in .planning/STATE.md. -- Add/confirm CI step to run utils/tests test:ci so unit tests are enforced in CI. -- Re-run CI (or run locally) a few times to confirm determinism and address flakiness if observed. - -## _Verifier: Claude (gsd-verifier)_ - -phase: 01-core-stabilization -verified: 2026-03-03T12:30:00Z -status: gaps_found -score: 11/13 -re_verification: -previous_status: gaps_found -previous_score: 9/13 -gaps_closed: - "05-PLAN.md frontmatter parse issue verified fixed (frontmatter present)" - "Research/audit/summary artifacts committed and recorded in STATE.md" -gaps_remaining: - "CI does not run utils/tests test:ci (unit tests not enforced in CI)" - "Bundle build determinism requires runtime validation in CI/local environment" -regressions: [] -gaps: - -- truth: "CI will run the same tests (CI wiring in separate plan)" - status: partial - reason: "CI workflow includes a bundle-size check but does not run @tsparticles/tests test:ci; unit tests are not enforced in CI." - artifacts: - - path: ".github/workflows/nodejs.yml" - issue: "Runs bundle-size check (BundleSize.test.ts) but no explicit step to run pnpm --filter @tsparticles/tests run test:ci." - missing: - - "Add CI step to run unit tests (pnpm --filter @tsparticles/tests run test:ci) or include utils tests in the affected test matrix." - -- truth: "Bundle build step runs deterministically in CI" - status: partial - reason: "Webpack configs exist but determinism is an empirical property requiring repeated builds in CI/local environment." - artifacts: - - path: "bundles/\*/webpack.config.js" - issue: "Configs present; determinism must be proven by repeated builds and output comparison." - missing: - - "Create a repeatable job/script that builds bundles multiple times and compares hashes/sizes to assert determinism." - -human_verification: - -- test: "Run utils unit tests locally" - expected: "pnpm --filter @tsparticles/tests run test:ci exits 0 and memoize/deepExtend tests pass consistently across repeated runs." - why_human: "This environment cannot execute the workspace test runner or CI; runtime verification requires execution in local or CI environment." - -- test: "Validate bundle determinism" - expected: "CI job or local script that builds bundles multiple times shows consistent outputs (hash/size)." - why_human: "Determinism requires empirical validation; grep-based static checks are insufficient." - -notes: - -- "Attempted to run gsd-tools plan-check but node module not found in this environment. Falling back to static verification (file presence, frontmatter, git index, grep for CI patterns)." -- "gsd-tools run error: Cannot find module '/Users/matteo/.claude/get-shit-done/bin/gsd-tools.cjs'" - -next_steps: - -- "Add a CI step to run unit tests: pnpm --filter @tsparticles/tests run test:ci (suggest inserting after 'Install dependencies' in .github/workflows/nodejs.yml)." -- "Create a small CI/local job that builds bundles multiple times and compares outputs to assert determinism." -- "If gsd-tools is available locally, re-run: node \"$HOME/.claude/get-shit-done/bin/gsd-tools.cjs\" plan-check .planning/phases/01-core-stabilization to produce machine-parsable verification output." -- "After gaps are closed, the orchestrator may run: node \"$HOME/.claude/get-shit-done/bin/gsd-tools.cjs\" phase complete \"01-core-stabilization\" (config.auto_advance is true)." - ---- - -# Phase 01: Core Stabilization — Verification Report - -Phase Goal: Ensure core runtime is correct and covered by tests. - -Verified: 2026-03-03T12:30:00Z -Status: gaps_found - -Summary - -- Plans inspected: .planning/phases/01-core-stabilization/\*-PLAN.md -- Total must-haves (truths) collected from plan frontmatter: 13 -- Verified (artifacts & wiring present): 11 -- Partial / needs runtime validation: 2 -- Failed / blocker: 0 - -Score: 11/13 must-haves verified (static checks + wiring) - -Highlights - -- engine/src/Utils/Utils.ts — memoize + deepExtend implementations — VERIFIED (present and substantive) -- utils/tests/src/tests/memoize.test.ts — exists and imports memoize — VERIFIED -- utils/tests/src/tests/deepExtend.test.ts — exists and imports deepExtend — VERIFIED -- utils/tests/src/Fixture/CustomCanvas.ts, Window.ts — deterministic jsdom/canvas helpers — VERIFIED -- bundles/\*/webpack.config.js — bundle configs present — VERIFIED -- utils/tests/package.json — contains test:ci script — VERIFIED - -Key Links Verified - -- tests -> engine utils imports (WIRED) -- bundle size test -> CI workflow (WIRED) - -Gaps Summary - -- CI unit test enforcement: CI workflow does not run pnpm --filter @tsparticles/tests run test:ci; add or confirm this step to ensure unit tests (memoize/deepExtend) are enforced in CI. -- Bundle determinism: cannot assert determinism statically; create CI or local validation job to build bundles multiple times and compare outputs. - -Human Verification Required - -- Run the utils unit tests locally or in CI and confirm consistent pass: pnpm --filter @tsparticles/tests run test:ci -- Run the repeat-build job to validate bundle determinism - -_Verifier: Claude (gsd-verifier)_ diff --git a/.planning/phases/01-core-stabilization/01-core-01-PLAN.md b/.planning/phases/01-core-stabilization/01-core-01-PLAN.md deleted file mode 100644 index 62da0351d44..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-01-PLAN.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 01 -type: tdd -wave: 1 -depends_on: [] -files_modified: - - engine/src/Utils/Utils.ts - - utils/tests/src/tests/memoize.test.ts - - utils/tests/package.json -autonomous: true -requirements: - - CORE-02 - - CORE-01 -user_setup: [] -must_haves: - truths: - - "Memoize behaviour is correct for primitive and object args (cache hit/miss observable)" - - "Memoize will not grow unbounded (supports optional max-size or TTL)" - - "Unit tests for memoize exist and run in CI/test runner" - artifacts: - - path: "engine/src/Utils/Utils.ts" - provides: "memoize function implementation" - - path: "utils/tests/src/tests/memoize.test.ts" - provides: "unit tests that assert memoize correctness and bounded cache behaviour" - key_links: - - from: "utils/tests/src/tests/memoize.test.ts" - to: "engine/src/Utils/Utils.ts" - via: "import { memoize } from '../../../../engine/src/Utils/Utils.js'" - pattern: "memoize\(" ---- - - -Stabilize and harden the `memoize` utility in engine/src/Utils/Utils.ts using a test-first (TDD) approach. - -Purpose: memoize is used across hot paths; unbounded caches and brittle keying have been flagged in research. This plan creates failing tests, implements a bounded, backward-compatible memoize, and proves behavior with unit tests so downstream work can rely on it. -Output: engine/src/Utils/Utils.ts (updated), utils/tests/src/tests/memoize.test.ts (new tests), package script adjustments if needed. - - - -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md -@.planning/research/SUMMARY.md -@engine/src/Utils/Utils.ts - - - - - - Task 1: Add failing tests for memoize (RED) - utils/tests/src/tests/memoize.test.ts - - - Test 1: memoize(fn) returns cached value for same primitive args - - Test 2: memoize(fn) differentiates object args by deep key (not by reference only) - - Test 3: bounded cache evicts older entries when maxSize reached - - Test 4: cache can be cleared if API exposes a clear() helper (optional) - - - Create a Vitest test file at utils/tests/src/tests/memoize.test.ts containing the above tests. Keep tests focused: require the memoize export from engine/src/Utils/Utils.js (Esm import path). Do not modify production code in this task. Commit the tests so they run (they will initially fail). - - - pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/memoize.test.ts" || true - - The new test file exists and the test runner executes the file (expected: failing tests present). - - - - Task 2: Implement bounded, backward-compatible memoize (GREEN) - engine/src/Utils/Utils.ts - - Modify memoize in engine/src/Utils/Utils.ts to preserve the existing function signature where possible but accept an optional options object: { maxSize?: number, ttlMs?: number, keyFn?: (args) => string }. - Implementation notes: - - Default behavior must remain the same for callers that pass only a function. - - Use a simple LRU-like eviction based on insertion order when maxSize is set. - - Avoid JSON.stringify-heavy keys by allowing a keyFn; default to a safer keyer that handles primitives and shallow objects (fall back to stable stringify for deep objects). - - Add a small internal Map cache and optional timestamps for ttlMs eviction. - - Add comments referencing research (.planning/research/PITFALLS.md) explaining tradeoffs. - - Keep changes minimal and well-typed; export any helper types if needed. - - - pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/memoize.test.ts" - - All memoize tests pass and new implementation exposes optional options (maxSize/ttlMs) while previous call sites that used memoize(fn) continue to function. - - - - - -Run the memoize-specific test file; tests must pass locally. The plan passes verification if the memoize tests are green and there is a small doc comment in Utils.ts describing the new options. - - - -- memoize tests pass: `pnpm --filter @tsparticles/tests test utils/tests/src/tests/memoize.test.ts` returns 0 -- engine/src/Utils/Utils.ts contains the bounded cache implementation and an exported type or JSDoc describing options -- No public API breaking changes for simple memoize(fn) callers - - - -After completion, create `.planning/phases/01-core-stabilization/01-core-01-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/01-core-01-SUMMARY.md b/.planning/phases/01-core-stabilization/01-core-01-SUMMARY.md deleted file mode 100644 index bcf02df47f1..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-01-SUMMARY.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 01 -subsystem: testing -tags: [memoize, utils, tdd, vitest] - -# Dependency graph -requires: - - phase: 00-initial - provides: [] -provides: - - Bounded memoize utility with tests -affects: [engine/utils] - -tech-stack: - added: [] - patterns: ["TDD: RED->GREEN for utility function", "Bounded cache defaults"]n+ - -key-files: - created: ["utils/tests/src/tests/memoize.test.ts"] - modified: ["engine/src/Utils/Utils.ts"] - -key-decisions: - - "Use insertion-order eviction for bounded memoize (simple LRU-like behavior)" - -patterns-established: - - "Prefer stable argument serialization for memoize keying; allow keyFn override" - -requirements-completed: [CORE-02, CORE-01] - -duration: 5min -completed: 2026-03-01 ---- - -# Phase 01 Plan 01: Memoize TDD Summary - -**Bounded memoize with stable keying and optional TTL/maxSize implemented and verified by unit tests.** - -## Performance - -- **Duration:** ~5 min -- **Started:** 2026-03-01T20:18:00Z -- **Completed:** 2026-03-01T20:24:00Z -- **Tasks:** 2 -- **Files modified:** 2 - -## Accomplishments - -- Added Vitest tests describing memoize behaviour (primitives, deep object keying, bounded eviction) -- Implemented bounded memoize with options: maxSize, ttlMs, keyFn -- Tests pass locally for the memoize test file - -## Task Commits - -1. **Task 1: Add failing tests for memoize (RED)** - `014d03f39b` (test) -2. **Task 2: Implement bounded, backward-compatible memoize (GREEN)** - `b6185092dc` (feat) - -**Plan metadata:** `docs: final commit` (not yet committed) - -## Files Created/Modified - -- `utils/tests/src/tests/memoize.test.ts` - Vitest tests asserting memoize behaviour -- `engine/src/Utils/Utils.ts` - Memoize implementation updated to support options and bounded cache - -## Decisions Made - -- Use insertion-order eviction (simple LRU-like) for bounded cache to keep implementation small and predictable. - -## Deviations from Plan - -None - plan executed as written. Implemented memoize per spec and added tests. - -## Issues Encountered - -- Running the single test file initially failed because dev dependencies were not installed; ran pnpm install for workspace which resolved the test runner. - -## Next Phase Readiness - -- Core memoize utility stabilized and tested; ready for downstream integration and CI validation. - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-01_ diff --git a/.planning/phases/01-core-stabilization/01-core-02-PLAN.md b/.planning/phases/01-core-stabilization/01-core-02-PLAN.md deleted file mode 100644 index 5b0b8d308ca..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-02-PLAN.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 02 -type: execute -wave: 1 -depends_on: [01] -files_modified: - - engine/src/Utils/Utils.ts - - utils/tests/src/tests/deepExtend.test.ts - - utils/tests/package.json -autonomous: true -requirements: - - CORE-02 -user_setup: [] -must_haves: - truths: - - "deepExtend merges objects without prototype pollution and preserves nested structures" - - "deepExtend performance regression avoided for common sizes" - - "Unit tests for deepExtend exist and run in CI" - artifacts: - - path: "engine/src/Utils/Utils.ts" - provides: "deepExtend implementation" - - path: "utils/tests/src/tests/deepExtend.test.ts" - provides: "unit tests asserting correctness and edge cases" - key_links: - - from: "utils/tests/src/tests/deepExtend.test.ts" - to: "engine/src/Utils/Utils.ts" - via: "import { deepExtend } from '../../../../engine/src/Utils/Utils.js'" - pattern: "deepExtend\(" ---- - - -Fix and harden deepExtend in engine/src/Utils/Utils.ts and add deterministic unit tests that cover nested merges and prototype/constructor edge cases. - -Purpose: deepExtend is used widely to merge options; issues here caused bugs and potential security concerns (proto pollution). This plan adds tests and small, safe fixes to the implementation. -Output: engine/src/Utils/Utils.ts (tweaked), utils/tests/src/tests/deepExtend.test.ts (new tests). - - - -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md -@.planning/research/PITFALLS.md -@engine/src/Utils/Utils.ts - - - - - - Task 1: Add tests for deepExtend edge cases - utils/tests/src/tests/deepExtend.test.ts - - Create Vitest tests that assert: - - deepExtend merges nested objects and arrays predictably - - deepExtend does not copy dangerous keys: "__proto__", "constructor", "prototype" - - Merging with undefined or null sources behaves sensibly - Keep tests focused and small. Import deepExtend from engine/src/Utils/Utils.js. - - - pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/deepExtend.test.ts" || true - - Test file exists and test runner executes (initially may fail). - - - - Task 2: Patch deepExtend to avoid proto/constructor copying - engine/src/Utils/Utils.ts - - Edit deepExtend implementation to explicitly ignore keys ["__proto__","constructor","prototype"] when merging plain objects. Add a small micro-optimization: for common shallow object merges, avoid deep recursion path. Add inline comment referencing PITFALLS.md. - - - pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/deepExtend.test.ts" - - deepExtend tests pass and implementation contains comment about prototype key filtering. - - - - - -Run deepExtend tests; they must pass locally. Check for presence of comment in Utils.ts indicating keys ignored. - - - -- deepExtend tests pass: `pnpm --filter @tsparticles/tests test utils/tests/src/tests/deepExtend.test.ts` returns 0 -- engine/src/Utils/Utils.ts contains explicit ignore list for dangerous keys -- No public API changes that break callers - - - -After completion, create `.planning/phases/01-core-stabilization/01-core-02-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/01-core-02-SUMMARY.md b/.planning/phases/01-core-stabilization/01-core-02-SUMMARY.md deleted file mode 100644 index a629be3de08..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-02-SUMMARY.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 02 -subsystem: utils -tags: [deepExtend, utils, security, tests] - -# Dependency graph -requires: - - phase: 01-core-stabilization - provides: core utilities stability -provides: - - hardened deepExtend implementation that avoids prototype pollution and adds a shallow-merge fast-path -affects: [engine utils consumers, tests] - -# Tech tracking -tech-stack: - added: [] - patterns: [defensive merging, test-first verification] - -key-files: - created: ["utils/tests/src/tests/deepExtend.test.ts"] - modified: ["engine/src/Utils/Utils.ts"] - -key-decisions: - - "Avoided prototype/constructor/prototype copying and added shallow-merge fast-path for performance" - -patterns-established: - - "Always filter dangerous keys when merging external data" - -requirements-completed: [CORE-02] - -# Metrics -duration: 5min -completed: 2026-03-01 ---- - -# Phase 01-core-stabilization Plan 02: deepExtend hardening summary - -deepExtend hardened to ignore prototype/constructor keys to prevent prototype pollution and a shallow-merge -fast-path was added to improve common-case performance; unit tests were added to verify behavior and edge cases. - -## Performance - -- **Duration:** 5 min -- **Started:** 2026-03-01T20:24:00Z -- **Completed:** 2026-03-01T20:29:00Z -- **Tasks:** 2 -- **Files modified:** 2 - -## Accomplishments - -- Added Vitest tests covering nested merges, arrays, prototype/constructor safety, and null/undefined handling -- Patched engine/src/Utils/Utils.ts to filter dangerous keys and include a shallow-merge fast-path - -## Task Commits - -Each task was committed atomically: - -1. **Task 1: Add tests for deepExtend edge cases** - `2f5add76f4` (test) -2. **Task 2: Patch deepExtend to avoid proto/constructor copying** - `c52c592e70` (fix) - -**Plan metadata:** `pending` (docs commit follows) - -## Files Created/Modified - -- `utils/tests/src/tests/deepExtend.test.ts` - Vitest tests for deepExtend edge cases -- `engine/src/Utils/Utils.ts` - deepExtend implementation hardened against prototype pollution and optimized - -## Decisions Made - -None - followed plan as specified. - -## Deviations from Plan - -None - plan executed as written. - -## Issues Encountered - -While running the workspace test command, other test suites failed due to unresolved package imports (@tsparticles/engine) in the utils/tests package environment. The verification for this plan targeted the deepExtend test specifically and that test passed when run in isolation. - -## User Setup Required - -None - -## Next Phase Readiness - -Core utilities hardened; ready for downstream integration and CI verification. - -## Self-Check - -FOUND: engine/src/Utils/Utils.ts -FOUND: utils/tests/src/tests/deepExtend.test.ts -FOUND: commit 2f5add76f4 -FOUND: commit c52c592e70 - -## Self-Check: PASSED diff --git a/.planning/phases/01-core-stabilization/01-core-03-PLAN.md b/.planning/phases/01-core-stabilization/01-core-03-PLAN.md deleted file mode 100644 index d6cf4a922e5..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-03-PLAN.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 03 -type: execute -wave: 2 -depends_on: [01, 02] -files_modified: - - utils/tests/src/tests/fixtures/canvas-fixtures.ts - - utils/tests/package.json -autonomous: true -requirements: - - TEST-01 -must_haves: - truths: - - "Canvas/jsdom test fixtures run deterministically in CI" - - "Test runner configuration for canvas fixtures is stable across environments" - - "CI runs test:ci without intermittent failures related to fixtures" - artifacts: - - path: "utils/tests/src/tests/fixtures/canvas-fixtures.ts" - provides: "stable fixtures for canvas-based unit tests" - key_links: - - from: "utils/tests/src/tests/fixtures/canvas-fixtures.ts" - to: "utils/tests/package.json" - via: "vitest configuration and test scripts" ---- - - -Stabilize canvas/jsdom fixtures used by utils tests so TEST-01 passes reliably in CI. - -Purpose: Flaky canvas fixtures cause non-deterministic test failures. This plan adds stable fixtures and a CI-friendly setup so tests run consistently. -Output: fixtures file updates and small test harness adjustments. - - - -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md -@.planning/research/PITFALLS.md - - - - - - Task 1: Add deterministic canvas fixtures - utils/tests/src/tests/fixtures/canvas-fixtures.ts - - Create or update fixtures to initialize a headless canvas with deterministic size, seedable RNG, and explicit devicePixelRatio. Export setup/teardown helpers for tests to call. Avoid network or system-dependent resources. - - - pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/fixtures/canvas-fixtures.ts" || true - - Fixtures file exists and can be imported by other tests; running the fixture test file executes (may initially fail until consumers updated). - - - - Task 2: Configure test:ci to run with stable environment - utils/tests/package.json - - Ensure package.json test:ci script uses `vitest run --maxConcurrency=2` (or similar) to reduce flakiness, and sets NODE_ENV=test. Add a note in README on running canvas tests locally. - - - pnpm --filter @tsparticles/tests run test:ci || true - - CI test script updated, and local invocation runs (initially may surface failures to fix in later iterations). - - - - - -Run `pnpm --filter @tsparticles/tests run test:ci` locally; observe reduced flakiness. This plan focuses on fixtures and runner config; follow-up may be needed if tests still show flakiness. - - - -- fixtures file present and imported by at least one test -- test:ci script updated in utils/tests/package.json -- Basic run of test:ci completes (may still fail if additional test fixes required) - - - -After completion, create `.planning/phases/01-core-stabilization/01-core-03-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/01-core-03-SUMMARY.md b/.planning/phases/01-core-stabilization/01-core-03-SUMMARY.md deleted file mode 100644 index 2fe0330c80e..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-03-SUMMARY.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 03 -subsystem: testing -tags: [vitest, jsdom, canvas, fixtures] - -# Dependency graph -requires: - - phase: 01-core-stabilization - provides: [foundation for stable tests] -provides: - - stable canvas fixtures for deterministic canvas-based tests -affects: [utils-tests, ci] - -# Tech tracking -tech-stack: - added: [none] - patterns: [deterministic test fixtures, seedable RNG for tests] - -key-files: - created: [utils/tests/src/tests/fixtures/canvas-fixtures.ts] - modified: [utils/tests/package.json] - -key-decisions: - - "Use small LCG RNG for deterministic randomness in fixtures" - -patterns-established: - - "Canvas fixtures expose setup/teardown helpers and a stable devicePixelRatio" - -requirements-completed: [TEST-01] - -# Metrics -duration: 5min -completed: 2026-03-01 ---- - -# Phase 01-core-stabilization Plan 03: Fixtures + test:ci script Summary - -Deterministic canvas fixtures with seedable RNG and CI-friendly vitest invocation to reduce flakiness in canvas-based tests. - -## Performance - -- **Duration:** ~5 min -- **Started:** 2026-03-01T -- **Completed:** 2026-03-01T -- **Tasks:** 2 -- **Files modified:** 2 - -## Accomplishments - -- Added deterministic canvas fixtures exporting setup/teardown helpers and a seedable RNG. -- Updated utils/tests/package.json test:ci script to set NODE_ENV=test and use vitest flags to limit concurrency. - -## Task Commits - -1. **Task 1: Add deterministic canvas fixtures** - `577b66d0e4` (feat) -2. **Task 2: Configure test:ci to run with stable environment** - `0dc83a85c4` (chore) - -**Plan metadata:** `N/A` - -## Files Created/Modified - -- `utils/tests/src/tests/fixtures/canvas-fixtures.ts` - deterministic fixtures and helpers -- `utils/tests/package.json` - adjusted test:ci script - -## Decisions Made - -- Use an internal LCG RNG (no external deps) for deterministic randomness in tests. - -## Deviations from Plan - -None - plan executed as specified. - -## Issues Encountered - - - Vitest in this environment does not support `--threads`; adjusted test flags to use `--maxWorkers`/`--maxConcurrency` alternatives where applicable. The chosen stable flags were compatible with the installed Vitest version. References to `--threads` in plans and verification updated to use `--maxConcurrency`. - -## User Setup Required - -None - no external service configuration required. - -## Next Phase Readiness - -- Ready for follow-up if tests still flake; next steps: instrument specific failing tests and reduce nondeterminism. - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-01_ diff --git a/.planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md b/.planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md deleted file mode 100644 index 548c0e3eb22..00000000000 --- a/.planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 04 -title: Phase 1 research: Validation Architecture & Risks ---- - -# Phase 1 — Core Stabilization: Research - -## Executive summary - -This phase focuses on documenting the validation architecture and making explicit where requirement CORE-02 (fixes in core utilities: memoize, deepExtend) is satisfied. The deliverable is a concise research summary that captures what we will validate in Phase 1, the testing stack, constraints, and a mapping from requirement IDs to artifacts or next steps. - -## Stack & constraints - -- Monorepo: pnpm + Nx workspace -- Test runner: Vitest (utils/tests package), Node + jsdom for DOM-related fixtures -- Language: TypeScript (>=5.x) -- CI: Nx Cloud / GitHub Actions (tests should be runnable via pnpm / nx commands) - -## Risks & pitfalls - -- Unbounded memoize/cache usage can cause memory growth in hot paths — use conservative defaults or require explicit options. -- Stable argument serialization for memoize may be expensive for complex objects; offer keyFn override and tests to justify default. -- Tests that rely on long-lived canvases or DOM interactions can be flaky in CI — prefer deterministic fixtures and headless environments. - -## Validation Architecture - -Purpose: define how we will verify Phase 1 outcomes (unit tests, CI checks, metrics) so downstream planners can rely on these guarantees. - -- Unit tests: Per-package Vitest suites (utils/tests) provide deterministic unit tests for utilities (memoize, deepExtend). Tests run locally via: pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/memoize.test.ts" and should be included in CI. -- CI gating: Nx/git workflows must include the utils/tests target in CI (affected or full) — failing tests block merges. -- Deterministic fixtures: Demo and integration tests should use deterministic canvas fixtures (already added in previous plans) to avoid flakiness. -- Metrics: Track test coverage for utils package and monitor regression via CI artifacts. Add simple test coverage threshold for utils package in CI to catch regressions. -- Acceptance criteria: All memoize & deepExtend unit tests pass in CI and locally; no regressions in behavior for existing call sites (memoize(fn) remains compatible). - -## Requirement mapping - -- CORE-01: Stabilize core APIs — covered by memoize & deepExtend implementations + tests (see utils/tests/src/tests/memoize.test.ts and engine/src/Utils/Utils.ts) -- CORE-02: Fix issues in Utils.ts (memoize, deepExtend) — evidence and mapping provided in CORE-02-AUDIT.md -- TEST-01: CI/test coverage and deterministic fixtures — covered by utils/tests and fixtures added in earlier plans (see .planning/phases/01-core-stabilization/01-core-01-SUMMARY.md) - -## References - -- engine/src/Utils/Utils.ts — memoize & deepExtend implementations -- utils/tests/src/tests/memoize.test.ts — unit tests covering memoize behavior -- .planning/phases/01-core-stabilization/CORE-02-AUDIT.md — audit mapping for CORE-02 diff --git a/.planning/phases/01-core-stabilization/02-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/02-PLAN-SUMMARY.md deleted file mode 100644 index d13a312c777..00000000000 --- a/.planning/phases/01-core-stabilization/02-PLAN-SUMMARY.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 02 -subsystem: testing/ci -tags: [bundle, ci, vitest, webpack, gzip] - -# Dependency graph -requires: - - phase: 01-core-stabilization-01 - provides: tests and core fixes -provides: - - "Bundle size test and CI job to prevent regressions" - -# Tech tracking -tech-stack: - added: [gzip-size] - patterns: [ci-enforced-budgets] - -key-files: - created: - - utils/tests/src/tests/BundleSize.test.ts - modified: - - .github/workflows/nodejs.yml - -key-decisions: - - "Add CI bundle size test that builds bundles and measures gzipped sizes" - -requirements-completed: [BUNDLE-01] - -# Metrics -duration: 0min -completed: 2026-03-03 ---- - -# Phase 01-core-stabilization Plan 02 Summary - -**CI-enforced gzipped bundle size budgets for slim/full/pjs bundles** - -## Performance - -- **Duration:** 0 min -- **Started:** 2026-03-03T00:00:00Z -- **Completed:** 2026-03-03T00:00:00Z -- **Tasks:** 2 -- **Files modified:** 2 - -## Accomplishments - -- Added BundleSize.test.ts which builds configured bundles via their webpack configs and asserts gzipped sizes against budgets. -- Updated CI workflow to run the bundle size test after build. - -## Task Commits - -1. **Task 1: Add bundle size test and budget config** - `b8d614c` (test) -2. **Task 2: CI integration — run bundle size test in GitHub Actions** - `12e9568` (docs) - -**Plan metadata:** `TODO` (docs: complete plan) - -## Files Created/Modified - -- `utils/tests/src/tests/BundleSize.test.ts` - Vitest test that builds bundles and measures gzipped size -- `.github/workflows/nodejs.yml` - Run bundle size test as part of CI - -## Decisions Made - -None - followed plan as specified - -## Deviations from Plan - -None - plan executed as written - -## Issues Encountered - -None - -## User Setup Required - -None - -## Next Phase Readiness - -- Ready for validating bundle budgets in CI; recommend running in PRs to observe baseline sizes and adjust budgets if false positives occur. - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-03_ diff --git a/.planning/phases/01-core-stabilization/02-PLAN.md b/.planning/phases/01-core-stabilization/02-PLAN.md deleted file mode 100644 index ddb326df69f..00000000000 --- a/.planning/phases/01-core-stabilization/02-PLAN.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 02 -type: execute -wave: 1 -depends_on: [01] -files_modified: - - utils/tests/src/tests/BundleSize.test.ts - - .github/workflows/ci.yml - - bundles/*/webpack.config.js -autonomous: true -requirements: [BUNDLE-01] -user_setup: [] -must_haves: - truths: - - "CI enforces bundle size budgets and fails on regression" - - "Bundle build step runs deterministically in CI" - artifacts: - - path: "bundles/*/webpack.config.js" - provides: "Bundle build configs and size budget hints" - - path: ".github/workflows/ci.yml" - provides: "CI job that runs the bundle size check" - key_links: - - from: ".github/workflows/ci.yml" - to: "bundles/*/" - via: "pnpm run slimbuild / webpack build" ---- - - -Add automated bundle size checks to CI to prevent regressions in published bundles. - -Purpose: Keep distribution bundles within size budgets (prevent weight creep) and surface regressions early in CI. -Output: CI job and tests that measure bundle sizes and fail if budgets exceeded. - - - -@.planning/PROJECT.md -@.planning/REQUIREMENTS.md - - - -This plan depends on Plan 01 (tests and core fixes). It adds CI-level checks that measure bundle sizes produced by existing `bundles/*` configs. - - - - - - Task 1: Add bundle size test and budget config - utils/tests/src/tests/BundleSize.test.ts - - Create a test that builds the bundles (using existing build scripts or webpack configs) in a fast, CI-friendly mode and measures output size for configured bundles. Define budgets per bundle (e.g., slim: 50KB gzipped, full: 200KB gzipped). Use `gzip-size` or `brotli-size` to measure compressed size. The test should fail if any bundle exceeds its budget. Keep runtimes reasonable — use single-file builds or reuse existing build artifacts when possible. - - - pnpm exec vitest run utils/tests/src/tests/BundleSize.test.ts --run - - Bundle size test exists and fails when artificially increasing bundle content past budget. Test committed. - - - - Task 2: CI integration — run bundle size test in GitHub Actions - .github/workflows/ci.yml - - Update CI workflow to run the bundle size tests as a job after building bundles. Ensure job uses Node 18+, caches pnpm store, and uploads artifacts when size check fails for debugging. The CI job should exit non-zero when budgets are exceeded. - - - node -e "console.log('CI job updated')" && git --no-pager diff -- .github/workflows/ci.yml | cat - - CI workflow updated and staged for commit. Job integrated into existing pipeline and documented in the plan summary. - - - - - -Run the bundle size test locally and ensure CI workflow contains the job. - -Automated: `pnpm exec vitest --run utils/tests/src/tests/BundleSize.test.ts` - - - - -- Bundle size test exists and reliably detects regressions -- CI workflow updated to run the size check -- Requirement BUNDLE-01 covered - - - -After completion, create `.planning/phases/01-core-stabilization/02-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md deleted file mode 100644 index 56539ec86be..00000000000 --- a/.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 03 -subsystem: testing/verification -tags: [plan-check, verification, gating] - -# Dependency graph -requires: - - phase: 01-core-stabilization/01 - provides: "Unit-tested core utilities and deterministic fixtures" - - phase: 01-core-stabilization/02 - provides: "CI bundle size budgets and CI integration" -provides: - - "Phase planning verification report and human approval checkpoint" -affects: [execution-readiness] - -# Tech tracking -tech-stack: - added: [] - patterns: ["Plan-check gating before execution", "Human-in-the-loop verification"] - -key-files: - created: [.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md] - modified: [.planning/phases/01-core-stabilization/VERIFICATION.md] - -key-decisions: - - "None - followed plan as specified" - -patterns-established: - - "Run plan-checker across phase artifacts and require human approval before marking phase ready" - -requirements-completed: [TEST-01] - -# Metrics -duration: 5min -completed: 2026-03-03 ---- - -# Phase 01-core-stabilization: Plan 03 Summary - -**Phase planning verification and gating: plan-checker output aggregated and human approval recorded for Core Stabilization (TEST-01 coverage).** - -## Performance - -- **Duration:** 5 min -- **Started:** 2026-03-03T11:08:28Z -- **Completed:** 2026-03-03T11:08:28Z -- **Tasks:** 3 -- **Files modified:** 2 - -## Accomplishments - -- Aggregated plan-checker results for phase 01 and ensured TEST-01 requirement coverage was present. -- Verified VERIFICATION.md exists and contains a recorded human approval. -- Created this Plan 03 Summary documenting verification status and next steps for execution. - -## Task Commits - -Each automated task should be committed atomically. Related commits in this execution: - -1. **Task 1: Run plan-checker over phase plans** - `dd11a3c` (chore) - plan-checker output recorded in VERIFICATION.md -2. **Task 2: Human verification checkpoint** - `7b092f9` (docs) - human approval recorded in VERIFICATION.md (existing commit) -3. **Task 3: Write phase summary and finalize artifacts** - `TASK_COMMIT` (docs) - this commit adds 03-PLAN-SUMMARY.md and updates STATE.md - -## Files Created/Modified - -- `.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md` - this file (phase summary for Plan 03) -- `.planning/phases/01-core-stabilization/VERIFICATION.md` - plan-checker output (existing) - -## Decisions Made - -None - followed plan as specified. - -## Deviations from Plan - -None - plan executed as written. The plan-checker surfaced an unrelated missing frontmatter issue for 05-PLAN.md which was approved to proceed and is documented in VERIFICATION.md. - -## Issues Encountered - -- None affecting Plan 03. Note: repository shows untracked PLAN files for 04 and 05 in the working tree; these do not block this summary but should be committed or cleaned as appropriate. - -## User Setup Required - -None - no external service configuration required for this plan. - -## Next Phase Readiness - -- Phase planning verified and approved; ready to proceed with execution tasks for Core Stabilization. - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-03_ - -## CHECKPOINT RESOLUTION - -- **Human checkpoint response:** `approved` -- **Approved at (as recorded in VERIFICATION.md):** 2026-03-03T10:22:45Z -- **Recorded by agent:** 2026-03-03T11:40:18Z (UTC) - -This summary was updated to reflect the human approval of the plan-checker results and to finalize the Plan 03 gating step. Any follow-up work (e.g., fixing 05-PLAN.md frontmatter) should be scheduled separately. diff --git a/.planning/phases/01-core-stabilization/03-PLAN.md b/.planning/phases/01-core-stabilization/03-PLAN.md deleted file mode 100644 index bd3d112d14c..00000000000 --- a/.planning/phases/01-core-stabilization/03-PLAN.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 03 -type: execute -wave: 2 -depends_on: [01, 02] -files_modified: - - .planning/phases/01-core-stabilization/03-PLAN.md - - .planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md -autonomous: false -requirements: [TEST-01] -user_setup: [] -must_haves: - truths: - - "Plans and changes are verified by plan-checker and pass must-have checks" - - "All phase artifacts committed and a phase summary exists" - artifacts: - - path: ".planning/phases/01-core-stabilization/*-PLAN.md" - provides: "All PLAN.md artifacts for phase" - - path: ".planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md" - provides: "Human-readable summary of completed work" - key_links: - - from: ".planning/phases/01-core-stabilization/" - to: ".planning/ROADMAP.md" - via: "plan files reference requirement IDs" ---- - - -Finalize planning verification for Phase 1 and prepare phase summary. This plan is a checkpoint that requires human approval after automated verification. - -Purpose: Ensure the planner's outputs satisfy goal-backward must-haves and produce a concise phase summary for onboarding developers. -Output: Verification pass, phase summary file, and explicit PRD mapping confirmation. - - - -@.planning/PROJECT.md -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md - - - -This plan runs after implementation plans (01, 02). It primarily aggregates verification results and requires a human checkpoint to confirm the phase is ready to execute. - - - - - - Task 1: Run plan-checker over phase plans - - - Run the gsd-plan-checker against all PLAN.md files in this phase directory. Produce `.planning/phases/01-core-stabilization/VERIFICATION.md` capturing PASS/FAIL and structured issues. Use the checker agent if available; otherwise run local static validations (frontmatter presence, must_haves existence, requirement coverage). - - - node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" plan-check .planning/phases/01-core-stabilization || true - - VERIFICATION.md exists with either `## VERIFICATION PASSED` or `## ISSUES FOUND` and structured output. Automated command executed. - - - - Phase 1 planning: plans + verification results - - 1. Review `.planning/phases/01-core-stabilization/VERIFICATION.md` for any `ISSUES FOUND` entries. - 2. Open PLAN.md files: `.planning/phases/01-core-stabilization/*-PLAN.md` and check `requirements` coverage and `must_haves` alignment with ROADMAP.md goal. - 3. Confirm that tests and CI changes are small, documented, and safe to run in CI. - 4. If acceptable, type `approved`. If not, describe issues to iterate. - - Type `approved` to continue or describe issues to revise - - - - Task 3: Write phase summary and finalize artifacts - .planning/phases/01-core-stabilization/01-PLAN-SUMMARY.md - - Create a short summary file containing: list of plans created, files modified, verification status, and next steps (`/gsd-execute-phase 1`). Include line references to key artifacts. - Commit summary and VERIFICATION.md along with plan files. - - - wc -l .planning/phases/01-core-stabilization/*-PLAN.md .planning/phases/01-core-stabilization/VERIFICATION.md || true - - Summary file exists and committed. Verification file present. User has approved via checkpoint. - - - - - -Overall: The phase is ready for execution when the checkpoint task returns `approved` and VERIFICATION.md reports `VERIFICATION PASSED` or user explicitly overrides. - - - - -- Plan-checker run and VERIFICATION.md created -- Human approval received -- Phase summary written and committed - - - -After completion, create `.planning/phases/01-core-stabilization/03-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md deleted file mode 100644 index ca7b474ef9e..00000000000 --- a/.planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 04 -subsystem: research -tags: [validation, audit, memoize] -requires: - - CORE-02 -provides: - - Phase-scoped research and CORE-02 audit mapping -affects: [planning, verification] - -tech-stack: - added: [] - patterns: ["research-summary", "validation-architecture"] - -key-files: - created: - [ - ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md", - ".planning/phases/01-core-stabilization/CORE-02-AUDIT.md", - ] - modified: [] - -key-decisions: ["CORE-02 is satisfied at artifact level; CI run required to fully verify"] - -requirements-completed: [CORE-02] - -# Metrics -duration: 1min -completed: 2026-03-03 ---- - -# Phase 01 Plan 04: Research & CORE-02 Audit Summary - -Validation architecture and short audit mapping CORE-02 to existing artifacts or small remediation tasks. - -## Performance - -- **Duration:** 1 min -- **Started:** 2026-03-03T00:00:00Z -- **Completed:** 2026-03-03T00:01:00Z -- **Tasks:** 2 -- **Files modified:** 3 - -## Accomplishments - -- Created phase-scoped research with a "## Validation Architecture" section. -- Produced CORE-02 audit that points to engine/src/Utils/Utils.ts and utils/tests/src/tests/memoize.test.ts and defines a minimal remediation plan if CI verification is missing. - -## Task Commits - -1. **Task 1: Create phase RESEARCH.md** - added in this commit -2. **Task 2: CORE-02 Audit** - added in this commit - -## Decisions Made - -- CORE-02 is considered satisfied at the artifact level; CI test execution is required to fully verify behavior in target environments. - -## Deviations from Plan - -None - plan executed as specified. - -## Issues Encountered - -None - -## Next Phase Readiness - -- Ready for CI verification and any small TDD remediation tasks if CI uncovers regressions. diff --git a/.planning/phases/01-core-stabilization/04-PLAN.md b/.planning/phases/01-core-stabilization/04-PLAN.md deleted file mode 100644 index f41186b06fd..00000000000 --- a/.planning/phases/01-core-stabilization/04-PLAN.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 04 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md -autonomous: true -requirements: [CORE-02] -user_setup: [] -must_haves: - truths: - - "Phase-scoped research summary exists and documents Validation Architecture for Phase 1" - - "Requirement CORE-02 is explicitly mapped to existing artifacts or has a small remediation plan" - - "A lightweight audit file lists where CORE-02 is satisfied (tests, code, plans) or what remains to be done" - artifacts: - - path: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - provides: "Phase research, risks, validation architecture, and implementation notes" - - path: ".planning/phases/01-core-stabilization/CORE-02-AUDIT.md" - provides: "Mapping of CORE-02 to code, tests, and plans, plus remediation steps if missing" - key_links: - - from: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - to: ".planning/ROADMAP.md" - via: "explicit mapping of requirement IDs and validation architecture" ---- - - -Produce phase-scoped research and a short audit that proves requirement CORE-02 is covered (or defines a minimal remediation plan). - -Purpose: Ensure the planner + executor have clear, phase-scoped research (including Validation Architecture) and that CORE-02 is not left unaddressed before execution. -Output: .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md and CORE-02-AUDIT.md - - - -@.planning/PROJECT.md -@.planning/ROADMAP.md -@.planning/STATE.md - - - -Roadmap: Phase 1 — Core Stabilization (requirements: CORE-01, CORE-02, TEST-01). Existing plans 01-03 implement many items but CORE-02 is not referenced by existing PLAN.md files. This plan creates phase research and performs a focused audit for CORE-02 so the requirement coverage rule is satisfied. - - - - - - Task 1: Create phase-scoped RESEARCH.md (Validation Architecture included) - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - Create a phase-scoped research document at the listed path. Use ROADMAP.md (phase goal & req IDs), STATE.md (recent decisions / commits), and existing global research under .planning/research/ as inputs. The RESEARCH.md must contain: - - Executive summary (what to build and why) - - Stack and constraints relevant to tests and fixtures - - Risks & pitfalls (short list) - - Validation Architecture: how this phase will be validated (unit tests, CI checks, metrics) - - Explicit mapping of requirement IDs (CORE-01, CORE-02, TEST-01) to suggested artifacts or plans - - Keep the file concise (~200-600 words). If previous research already exists under .planning/research/, summarize and link to it. Commit the file. - - - - test -f .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md && echo OK - - RESEARCH.md exists, contains a '## Validation Architecture' section, and maps requirement IDs to artifacts or next steps. - - - - Task 2: CORE-02 audit — map or create remediation plan - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md - - Create an audit file that proves where CORE-02 is satisfied or describes minimal remediation. Steps: - 1. Search the repo for code/tests referencing memoize/deepExtend and their tests (engine/src/Utils, utils/tests). List matching files with short notes. - 2. If a test or plan already satisfies CORE-02, point to the exact file(s) and line numbers where behavior is covered. - 3. If coverage is missing, add a short remediation plan: one TDD task (test file path + implementation file path) with acceptance criteria and an estimate (Claude execution time only). - - Write findings into CORE-02-AUDIT.md and commit. - - - - node -e "const fs=require('fs'); process.exit(fs.existsSync('.planning/phases/01-core-stabilization/CORE-02-AUDIT.md')?0:1)" && grep -n "CORE-02" .planning/phases/01-core-stabilization/CORE-02-AUDIT.md || true - - Audit file exists and either references existing artifacts that satisfy CORE-02 or includes a 1-2 task remediation plan with clear acceptance criteria. - - - - - -Automated checks: -- RESEARCH.md file exists and contains the string '## Validation Architecture' -- CORE-02-AUDIT.md exists and references either code/tests or includes a remediation task - -Automated: test -f .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md && grep -q "## Validation Architecture" .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md && test -f .planning/phases/01-core-stabilization/CORE-02-AUDIT.md - - - - -- Phase RESEARCH.md created and committed -- CORE-02 requirement explicitly mapped to artifacts or has a small remediation plan (tasks) in CORE-02-AUDIT.md -- This PLAN.md lists CORE-02 in `requirements` frontmatter (satisfies mapping rule) - - - -After completion, create `.planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md deleted file mode 100644 index c640502ee26..00000000000 --- a/.planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 05 -subsystem: testing/verification -tags: [plan-check, verification, research] - -# Dependency graph -requires: - - phase: 01-core-stabilization - provides: Validation Architecture, plan verification -provides: - - Phase research document with Validation Architecture - - VERIFICATION.md from plan-checker -affects: [execution readiness] - -tech-stack: - added: [] - patterns: [plan-check gating, concise research doc] - -key-files: - created: - [ - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md, - .planning/phases/01-core-stabilization/VERIFICATION.md, - ] - modified: [] - -key-decisions: - - "Run plan-checker and surface issues for human review" - -patterns-established: - - "Plan-check gating before execution: all PLAN.md must be verified" - -requirements-completed: [CORE-01, CORE-02, TEST-01] - -# Metrics -duration: 1min -completed: 2026-03-03 ---- - -# Phase 01: Core Stabilization — Plan 05 Summary - -**One-liner:** Phase research validated and plan-checker run across phase plans; issues discovered in PLAN.md frontmatter (05-PLAN.md missing frontmatter). - -## Performance - -- **Duration:** 1 min -- **Started:** 2026-03-03T10:21:43Z -- **Completed:** 2026-03-03T10:21:43Z -- **Tasks:** 3 -- **Files modified:** 2 - -## Accomplishments - -- Created concise phase RESEARCH.md with Validation Architecture -- Ran static plan-checker and produced VERIFICATION.md -- Created this plan summary to surface verification results and next steps - -## Task Commits - -1. **Task 1: Create or update phase RESEARCH.md including Validation Architecture** - (will be committed in this execution) -2. **Task 2: Run plan-checker to produce VERIFICATION.md** - dd11a3cd7d (chore) -3. **Task 4: Write short phase summary and next steps** - (this file) - -## Files Created/Modified - -- .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - Phase research and Validation Architecture -- .planning/phases/01-core-stabilization/VERIFICATION.md - Plan-checker output - -## Decisions Made - -- Run plan-checker and surface issues for human review - -## Deviations from Plan - -**1. [Rule 3 - Blocking] 05-PLAN.md missing frontmatter** - -- **Found during:** Task 2 (Run plan-checker) -- **Issue:** The 05-PLAN.md file did not contain YAML frontmatter at the top, causing the checker to fail to parse it. -- **Fix:** SURFACE ONLY — did not modify PLAN.md. Added VERIFICATION.md documenting the issue and committed the verification report for human review. -- **Files modified:** .planning/phases/01-core-stabilization/VERIFICATION.md -- **Commit:** dd11a3cd7d - -## CHECKPOINT RESOLUTION - -- Human verification: approved -- Approved at: 2026-03-03T10:22:45Z -- Note: Proceeding with execution despite the missing frontmatter in 05-PLAN.md. Recommend fixing 05-PLAN.md frontmatter in a follow-up commit. - -## Issues Encountered - -- 05-PLAN.md missing expected frontmatter fields. Needs manual edit to restore frontmatter keys (phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves). - -## User Setup Required - -None - -## Next Steps - -- Please open .planning/phases/01-core-stabilization/05-PLAN.md and add the required YAML frontmatter fields. Once updated, re-run or indicate to proceed with known issues. - ---- - -_Phase: 01-core-stabilization_ -_Completed: 2026-03-03_ diff --git a/.planning/phases/01-core-stabilization/05-PLAN.md b/.planning/phases/01-core-stabilization/05-PLAN.md deleted file mode 100644 index a10bf3b5d5f..00000000000 --- a/.planning/phases/01-core-stabilization/05-PLAN.md +++ /dev/null @@ -1,139 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 05 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - .planning/phases/01-core-stabilization/VERIFICATION.md - - .planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md -autonomous: false -requirements: [CORE-01, CORE-02, TEST-01] -user_setup: [] -must_haves: - truths: - - "Phase research with a clear Validation Architecture exists and is discoverable by executors" - - "All PLAN.md files in the phase have been checked by the plan-checker and any issues are recorded in VERIFICATION.md" - - "A concise phase summary exists that lists plans, verification status, and explicit next steps for execution" - artifacts: - - path: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - provides: "Phase-scoped research including Validation Architecture and requirement mappings" - - path: ".planning/phases/01-core-stabilization/VERIFICATION.md" - provides: "Structured verification output from gsd-plan-checker (PASS / ISSUES FOUND)" - - path: ".planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md" - provides: "Human-readable summary and next steps for execute-phase" - key_links: - - from: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - to: ".planning/ROADMAP.md" - via: "explicit mapping of requirement IDs and Validation Architecture" - - from: ".planning/phases/01-core-stabilization/VERIFICATION.md" - to: ".planning/phases/01-core-stabilization/*-PLAN.md" - via: "checker references and issue pointers" ---- - - -Ensure Phase 1 has an up-to-date research document with a Validation Architecture, run plan-level verification across all PLAN.md artifacts, and produce a short phase summary that records verification results and next steps. - -Purpose: Provide a single, easy-to-run plan that integrates research (if missing), automated verification, and a human checkpoint so the phase can safely move to execution. -Output: RESEARCH.md (created/updated), VERIFICATION.md (checker output), 05-PLAN-SUMMARY.md (phase summary) - - - -@.planning/PROJECT.md -@.planning/REQUIREMENTS.md -@.planning/ROADMAP.md - - - -Phase 1: Core Stabilization — Goal: Ensure core runtime is correct and covered by tests (ROADMAP.md). This plan focuses on integration: ensure research and validation architecture exist, run the plan-checker across existing PLAN.md files, and produce a human-reviewable summary. - -References used as inputs: existing plans in this directory, `.planning/research/*`, and ROADMAP.md. - - - - - - Task 1: Create or update phase RESEARCH.md including Validation Architecture - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - If the research file does not exist, create `.planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md`. If it exists, open and ensure it contains a `## Validation Architecture` section and explicit mapping for requirement IDs (CORE-01, CORE-02, TEST-01). Use `.planning/research/STACK.md`, `.planning/research/FEATURES.md`, ROADMAP.md, and STATE.md as inputs. Keep the document concise (200-600 words) and include: - - Executive summary - - Stack & constraints relevant to tests/fixtures - - Risks & short mitigations - - "## Validation Architecture" describing how the phase will be validated (unit tests, CI bundle checks, fixtures, plan-checker gating) - - Requirement ID mapping (one line per ID pointing to files or plans) - - Commit the file if created or updated. Follow repository doc formatting conventions. - - - - test -f .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md && grep -q "## Validation Architecture" .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - RESEARCH.md exists, contains a '## Validation Architecture' section, and contains mapping lines for CORE-01, CORE-02, TEST-01. - - - - Task 2: Run plan-checker to produce VERIFICATION.md - .planning/phases/01-core-stabilization/VERIFICATION.md - - Run the plan-checker over all PLAN.md files in this phase directory and write structured results to `.planning/phases/01-core-stabilization/VERIFICATION.md`. - Use the project's gsd-tools if available: `node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" plan-check .planning/phases/01-core-stabilization || true`. - If the checker is unavailable, perform static validations: ensure each PLAN.md has frontmatter fields `phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves` and that every requirement listed in ROADMAP.md for Phase 1 appears in at least one plan's `requirements` frontmatter. - Commit VERIFICATION.md. - - - node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" plan-check .planning/phases/01-core-stabilization > .planning/phases/01-core-stabilization/VERIFICATION.md || true && test -f .planning/phases/01-core-stabilization/VERIFICATION.md - - VERIFICATION.md exists and lists either `## VERIFICATION PASSED` or `## ISSUES FOUND` with structured issues. Results committed. - - - - Phase research + plan verification summary - - 1. Open `.planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md` and confirm it contains a `## Validation Architecture` section and requirement mappings. - 2. Open `.planning/phases/01-core-stabilization/VERIFICATION.md` and review `ISSUES FOUND` entries (if any). - 3. If issues exist, either type `approved` to proceed with known issues (override) or describe the issues to request revisions. - 4. If VERIFICATION.md shows `VERIFICATION PASSED`, type `approved` to continue to execution. - - Type `approved` to continue or describe issues to iterate - - - - Task 4: Write short phase summary and next steps - .planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md - - Create `.planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md` containing: - - Phase title & goal - - List of PLAN.md files and their `requirements` coverage - - Short excerpt from VERIFICATION.md (PASS or top 3 issues) - - Next steps: `/gsd-execute-phase 1` and any manual actions - Commit the summary file. - - - test -f .planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md && head -n 50 .planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md || true - - Summary file exists and documents plans, verification status, and next steps. File committed. - - - - - -Overall checks: -- RESEARCH.md exists and contains `## Validation Architecture`. -- VERIFICATION.md exists and contains structured output from the plan-checker. -- Human checkpoint approval recorded (resume-signal `approved`). - - - - -- RESEARCH.md created/updated and committed -- VERIFICATION.md created with PASS or structured ISSUES -- Phase summary file created and committed -- Requirements CORE-01, CORE-02, TEST-01 appear in at least one plan's `requirements` frontmatter across the phase - - - - -After completion, create `.planning/phases/01-core-stabilization/05-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/06-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/06-PLAN-SUMMARY.md deleted file mode 100644 index ca5e1479d05..00000000000 --- a/.planning/phases/01-core-stabilization/06-PLAN-SUMMARY.md +++ /dev/null @@ -1,45 +0,0 @@ -# Phase 01 Plan 06: Restore 05-PLAN frontmatter and re-check - -One-liner: Restore missing YAML frontmatter for plan 05 so the plan-checker can parse it and update verification. - -## Summary - -- Objective: Add YAML frontmatter to .planning/phases/01-core-stabilization/05-PLAN.md and re-run static parse/plan-checker, then update VERIFICATION.md. -- Tasks completed: 2/2 - -## Tasks - -1. Task 1: Add YAML frontmatter to 05-PLAN.md - - Commit: f61cda7c9e - - Files modified: .planning/phases/01-core-stabilization/05-PLAN.md - - Result: Frontmatter restored; file begins with '---' and contains required keys (phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves). - -2. Task 2: Re-run plan-checker (static parse) and update VERIFICATION.md - - Commit: 7670909b42 - - Files modified: .planning/phases/01-core-stabilization/VERIFICATION.md - - Result: VERIFICATION.md updated to note the restored frontmatter and reference commit f61cda7c9e. Suggested re-run of plan-checker if available. - -## Deviations from Plan - -None — changes limited to restoring frontmatter and updating verification as requested. - -## Verification - -- Local static check: .planning/phases/01-core-stabilization/05-PLAN.md starts with '---' and contains a 'phase: 01-core-stabilization' field. (Automated python/grep verified.) -- Recommended: Run the project's plan-checker (gsd-tools) locally to fully validate parsing: - - node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" plan-check .planning/phases/01-core-stabilization - -If gsd-tools is unavailable in this environment, the static checks above are sufficient for the gap fix. - -## Self-Check: PASSED - -Checked files exist and commits are present. - -## State / Next Steps - -- Update STATE.md via gsd-tools if available: - - node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state advance-plan - -- If git commit/push issues occur in this environment, follow local finalize instructions in .planning/STATE.md. diff --git a/.planning/phases/01-core-stabilization/06-PLAN.md b/.planning/phases/01-core-stabilization/06-PLAN.md deleted file mode 100644 index fa231f196b0..00000000000 --- a/.planning/phases/01-core-stabilization/06-PLAN.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 06 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .planning/phases/01-core-stabilization/05-PLAN.md -autonomous: true -requirements: [CORE-01] -user_setup: [] -must_haves: - truths: - - "05-PLAN.md contains valid YAML frontmatter so the plan-checker can parse it" - - "Plan-checker no longer reports frontmatter parsing errors for 05-PLAN.md" - artifacts: - - path: ".planning/phases/01-core-stabilization/05-PLAN.md" - provides: "Canonical PLAN.md metadata for plan 05 (frontmatter present and correct)" - key_links: - - from: ".planning/phases/01-core-stabilization/05-PLAN.md" - to: ".planning/phases/01-core-stabilization/VERIFICATION.md" - via: "Plan-checker parsing and verification" - pattern: "^phase: 01-core-stabilization" ---- - - -Restore missing YAML frontmatter for Plan 05 so the plan-checker can parse the file and the phase verification can pass. - -Purpose: The verifier flagged 05-PLAN.md as missing frontmatter. This gap plan adds the required YAML frontmatter fields and re-validates the plan with a plan-check run. -Output: Updated .planning/phases/01-core-stabilization/05-PLAN.md with required frontmatter and a successful static parse check. - - - -This is a focused gap-closure plan created from the phase verifier output (VERIFICATION.md). It must be small and deterministic: add YAML frontmatter only (do not change plan semantics). Execution may be automated fully. - - - - - - Task 1: Add YAML frontmatter to 05-PLAN.md - .planning/phases/01-core-stabilization/05-PLAN.md - - Edit .planning/phases/01-core-stabilization/05-PLAN.md to add the required YAML frontmatter at the top. The frontmatter must include: phase, plan, type, wave, depends_on, files_modified (can be empty array), autonomous, requirements (match phase requirements if relevant), must_haves (can be an empty array or a minimal placeholder). Do NOT modify the plan body below; only add/restore frontmatter. Commit the change with message: "docs(01-core-stabilization-05): restore YAML frontmatter for plan metadata". - Reason: A proper frontmatter allows the plan-checker to parse and include the plan in verification. - - - python - <<'PY' -import sys,ruamel.yaml -p=' .planning/phases/01-core-stabilization/05-PLAN.md' -with open(p,'r') as f: - s=f.read() -if s.lstrip().startswith('---'): - print('OK') - sys.exit(0) -else: - print('MISSING') - sys.exit(2) -PY - - 05-PLAN.md contains valid YAML frontmatter and the change is committed. - - - - Task 2: Re-run plan-checker (static parse) and update VERIFICATION.md - .planning/phases/01-core-stabilization/VERIFICATION.md - - Run the plan-checker (if available) or perform static validation: ensure every PLAN.md has the required frontmatter fields. Update .planning/phases/01-core-stabilization/VERIFICATION.md with the re-check results. Commit VERIFICATION.md. - If gsd-tools is not available in the environment, run local greps to validate frontmatter presence and write a small verification summary to VERIFICATION.md. - - - grep -q "^phase: 01-core-stabilization" .planning/phases/01-core-stabilization/05-PLAN.md && echo "RECHECK_OK" || echo "RECHECK_FAIL" - - VERIFICATION.md updated to reflect that 05-PLAN.md is parseable; plan-checker reports no frontmatter parse error for 05-PLAN.md. - - - - - -Overall: After these tasks, the plan-checker should no longer report a frontmatter parsing error for 05-PLAN.md. VERIFICATION.md should be updated and committed. - - - - -- .planning/phases/01-core-stabilization/05-PLAN.md contains YAML frontmatter and is parseable -- .planning/phases/01-core-stabilization/VERIFICATION.md updated to show the parse issue is resolved -- Commit(s) created for the frontmatter fix and updated verification - - - -After completion, create `.planning/phases/01-core-stabilization/06-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md deleted file mode 100644 index d006fdc05d9..00000000000 --- a/.planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md +++ /dev/null @@ -1,62 +0,0 @@ ---- - -phase: 01-core-stabilization -plan: 07 -subsystem: research -tags: [finalize, state, docs] -requires: - -- CORE-02 - provides: -- Finalize commit records for research & audit artifacts - affects: [planning, traceability] - -tech-stack: -added: [] -patterns: ["finalize-artifacts", "state-update"] - -key-files: -created: - .planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md -modified: - .planning/STATE.md - -key-decisions: ["Record commits for plan 04 artifacts in STATE.md; no further code changes required"] -requirements-completed: [CORE-02] - -# Phase 01 Plan 07: Finalize uncommitted artifacts (research & audit) - -One-liner: Record and finalize research/audit artifacts for Phase 01, Plan 04 by ensuring commit traces are present in STATE.md and creating this plan summary. - -## Summary - -This gap plan finalized the previously-uncommitted research and audit artifacts produced during Plan 04. The agent inspected the repo, found the files tracked in git, and recorded their most recent commit hashes in STATE.md for traceability. - -## Actions performed - -- Verified that the following files are present in the repository index and resolved to the listed commits: - - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md — db757cf24e - - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md — b8d614c99 - - .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md — 12e95684b - -- Updated .planning/STATE.md to remove the previous local-finalize instructions and to include the commit hashes above for traceability. - -## Verification - -- Confirmed files are tracked in git and have recent commits (git ls-files + git log queries). -- STATE.md now contains entries showing the commits recorded for the artifacts and guidance for local reconciliation if a developer's working copy is out of sync. - -## Deviations from Plan - -None — the plan executed as written. No additional code or tests were changed. - -## Final Notes / Developer actions - -If you encounter git ref locks or missing commits when syncing your local branch, reconcile with remote and reapply commits as necessary using the commands documented in STATE.md under "Finalize instructions for local environment". - -## Self-Check: PASSED - -Files created/modified: - -- .planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md (this file) -- .planning/STATE.md (updated with commit hashes and reconcile guidance) - -Completed: 2026-03-03 diff --git a/.planning/phases/01-core-stabilization/07-PLAN.md b/.planning/phases/01-core-stabilization/07-PLAN.md deleted file mode 100644 index 9403e18c89a..00000000000 --- a/.planning/phases/01-core-stabilization/07-PLAN.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 07 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md - - .planning/phases/01-core-stabilization/CORE-02-AUDIT.md - - .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md -autonomous: true -requirements: [CORE-02] -user_setup: [] -must_haves: - truths: - - "Research and audit artifacts are committed and discoverable in the phase directory" - - "STATE.md records no uncommitted artifacts for the phase" - artifacts: - - path: ".planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md" - provides: "Phase research with Validation Architecture" - - path: ".planning/phases/01-core-stabilization/CORE-02-AUDIT.md" - provides: "CORE-02 mapping and remediation plan" - key_links: - - from: ".planning/phases/01-core-stabilization/CORE-02-AUDIT.md" - to: ".planning/STATE.md" - via: "commit records and artifact presence" - pattern: "CORE-02" ---- - - -Commit phase research/audit artifacts that were left uncommitted due to local git locks during execution and ensure STATE.md records are accurate. - -Purpose: The verifier reported uncommitted artifacts (research, audit, summary) that reduce artifact durability. This gap plan stages and commits the created files with clear Conventional Commit messages. -Output: Committed RESEARCH.md, CORE-02-AUDIT.md, and 04-PLAN-SUMMARY.md; updated .planning/STATE.md reflecting no pending uncommitted artifacts. - - - -Executor agents created research and audit files (Plan 04) but some commits were blocked by git ref locks in the execution environment. This plan will finalize those artifacts as committed files. - - - - - - Task 1: Stage and commit research & audit artifacts - .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md, .planning/phases/01-core-stabilization/CORE-02-AUDIT.md, .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md - - Add the listed files to git and commit them with a Conventional Commit message: "docs(01-core-stabilization-04): add RESEARCH and CORE-02 audit (finalize artifacts)". If git fails due to environment lock, write a local note into .planning/STATE.md describing exact commands for local finalize and do not attempt further automated commits. - - - git ls-files --error-unmatch .planning/phases/01-core-stabilization/01-core-stabilization-RESEARCH.md .planning/phases/01-core-stabilization/CORE-02-AUDIT.md .planning/phases/01-core-stabilization/04-PLAN-SUMMARY.md >/dev/null 2>&1 && echo COMMITTED || echo MISSING - - Research, audit, and summary files are committed and present in the repository index, or STATE.md contains local-finalize instructions if commit failed. - - - - Task 2: Update STATE.md to clear pending artifacts - .planning/STATE.md - - Update .planning/STATE.md to remove or mark as committed the previously uncommitted artifacts. Add an entry noting the commit hashes for the artifacts if commits succeeded, or include local finalize instructions if commits were not possible. - - - grep -n "Research.*RESEARCH.md" .planning/STATE.md || true - - STATE.md updated to reflect artifact commit status or contains explicit local finalize instructions. - - - - - -After these tasks, no uncommitted phase artifacts should remain. state should reflect committed artifacts. If commits could not be made due to environment locks, STATE.md will contain clear instructions for local finalization. - - - - -- RESEARCH.md, CORE-02-AUDIT.md, and 04-PLAN-SUMMARY.md are committed or explicit local-finalize instructions exist in STATE.md -- STATE.md no longer lists those artifacts as pending/uncommitted - - - -After completion, create `.planning/phases/01-core-stabilization/07-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md deleted file mode 100644 index 4499afc10b9..00000000000 --- a/.planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 08 -summary: "Add CI enforcement to run workspace unit tests in nodejs workflow" ---- - -# Phase 01-core-stabilization Plan 08: Run test:ci in CI - -One-liner: Ensure workspace unit tests (utils/tests) are executed in CI via test:ci so regressions fail early. - -What changed - -- Modified: .github/workflows/nodejs.yml -- Commit: 59802249a2 (ci(bundles): add repeat-build determinism check to nodejs workflow) and earlier commit for test:ci step - -Verification - -- The workflow now contains a step that runs: pnpm --filter @tsparticles/tests run test:ci -- Grep check: grep -n "--filter @tsparticles/tests run test:ci" .github/workflows/nodejs.yml - -How to run locally - -- From repo root: pnpm --filter @tsparticles/tests run test:ci - -Notes - -- Keep an eye on CI run times; adjust concurrency flags in utils/tests/package.json if necessary. diff --git a/.planning/phases/01-core-stabilization/08-PLAN.md b/.planning/phases/01-core-stabilization/08-PLAN.md deleted file mode 100644 index 54d7c63050b..00000000000 --- a/.planning/phases/01-core-stabilization/08-PLAN.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 08 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .github/workflows/nodejs.yml -autonomous: true -requirements: [TEST-01] -user_setup: [] -must_haves: - truths: - - "CI runs the workspace unit tests (utils tests) as part of the nodejs workflow" - - "A failing unit test causes the CI job to exit non-zero" - artifacts: - - path: ".github/workflows/nodejs.yml" - provides: "CI job that runs pnpm --filter @tsparticles/tests run test:ci" - key_links: - - from: ".github/workflows/nodejs.yml" - to: "utils/tests/" - via: "pnpm --filter @tsparticles/tests run test:ci" - pattern: "test:ci|--filter @tsparticles/tests" ---- - - -Add CI enforcement to run the workspace unit tests (pnpm --filter @tsparticles/tests run test:ci) in the repository's Node.js workflow so unit regressions fail CI. - -Purpose: Ensure TEST-01 (unit tests enforced in CI) is validated by running the test:ci script during CI runs. -Output: Updated .github/workflows/nodejs.yml with an explicit step to run the utils test:ci script and a PLAN summary. - - - -The verifier reported that CI runs bundle-size checks but does not run the workspace unit tests. This small gap plan adds a single CI step and verifies presence. - - - - - - Task 1: Add unit-test step to CI workflow - .github/workflows/nodejs.yml - - Edit .github/workflows/nodejs.yml to add a job step after build/install that runs: - pnpm --filter @tsparticles/tests run test:ci - The step should use the existing Node matrix, run on the same runner, and upload test artifacts/logs when the job fails for debugging. Keep changes minimal and add comments describing the reason. - Commit with message: "ci(tests): run workspace unit tests in nodejs workflow" - - - grep -n "--filter @tsparticles/tests run test:ci" .github/workflows/nodejs.yml || true - - CI workflow updated; the workflow file contains the test:ci step and is committed. - - - - Task 2: Create PLAN summary and sanity-check CI step - .planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md - - Create a short summary file listing the change, the modified workflow, the commit hash, and verification instructions for maintainers (how to run the step locally). Commit the summary. - - - test -f .planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md && echo OK || echo MISSING - - Summary file exists and documents the CI change and verification steps. - - - - - -After implementing tasks, ensure git commits exist for the workflow change and that the test command appears in the workflow file. Recommend running the test:ci locally once before pushing. - - - - -- .github/workflows/nodejs.yml contains the test:ci step -- .planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md exists and is committed - - - -After completion, create `.planning/phases/01-core-stabilization/08-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md b/.planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md deleted file mode 100644 index 596a23c7775..00000000000 --- a/.planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 09 -summary: "Add bundle determinism verification script and CI wiring" ---- - -# Phase 01-core-stabilization Plan 09: Bundle determinism check - -One-liner: Add a simple repeat-build script that rebuilds bundles twice and compares outputs to detect nondeterminism. - -What changed - -- Added: scripts/verify-bundle-determinism.sh (executable) -- Modified: .github/workflows/nodejs.yml to run the determinism check -- Commit: 0a466ac89e (feat add script), 59802249a2 (ci wiring) - -Verification - -- Script exists and is executable: test -f scripts/verify-bundle-determinism.sh && test -x scripts/verify-bundle-determinism.sh -- Workflow contains reference: grep -n "verify-bundle-determinism" .github/workflows/nodejs.yml -- Recommended: run ./scripts/verify-bundle-determinism.sh locally (may be slow) - -Notes - -- The script uses pnpm run build:ci and may require network and build tooling; CI will run it in the same environment. diff --git a/.planning/phases/01-core-stabilization/09-PLAN.md b/.planning/phases/01-core-stabilization/09-PLAN.md deleted file mode 100644 index e2ce532bf01..00000000000 --- a/.planning/phases/01-core-stabilization/09-PLAN.md +++ /dev/null @@ -1,97 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 09 -type: execute -wave: 1 -depends_on: [] -files_modified: - - .github/workflows/nodejs.yml - - scripts/verify-bundle-determinism.sh -autonomous: true -requirements: [BUNDLE-01] -user_setup: [] -must_haves: - truths: - - "A CI/local job exists that builds bundles multiple times and compares outputs to detect non-determinism" - - "The job fails if bundle outputs differ across repeated builds" - artifacts: - - path: "scripts/verify-bundle-determinism.sh" - provides: "Script that builds bundles twice and compares gzipped sizes / SHA256 of outputs" - - path: ".github/workflows/nodejs.yml" - provides: "CI job that runs the determinism check" - key_links: - - from: ".github/workflows/nodejs.yml" - to: "bundles/*/" - via: "run: ./scripts/verify-bundle-determinism.sh" - pattern: "verify-bundle-determinism" ---- - - -Add a reproducible determinism check for bundle builds. This script builds configured bundles twice in a clean environment, compares gzipped sizes and SHA256 hashes of outputs, and fails if differences are detected. Wire it into CI as a lightweight job. - -Purpose: Detect non-determinism in bundle outputs early by adding an automated repeat-build comparison. -Output: scripts/verify-bundle-determinism.sh and a CI workflow job that runs it; PLAN summary. - - - -Bundle determinism is necessary to trust bundle-size budgets and repeatable CI artifacts. This plan creates a simple script and CI wiring to validate determinism. - - - - - - Task 1: Add determinism verification script - scripts/verify-bundle-determinism.sh - - Create a shell script at scripts/verify-bundle-determinism.sh that: - - Runs the project's bundle build (pnpm run slimbuild or the relevant build command) twice into separate temp directories - - For each bundle file (JS output), compute gzipped size and SHA256 hash - - Compare results; exit non-zero if any mismatch. Provide clear stdout for debugging. - Make the script executable and document usage in a comment header. Commit the script. - - - test -f scripts/verify-bundle-determinism.sh && echo OK || echo MISSING - - Script exists, is executable, and documented. Commited. - - - - Task 2: Wire determinism check into CI workflow - .github/workflows/nodejs.yml - - Update .github/workflows/nodejs.yml to add a job or step that runs ./scripts/verify-bundle-determinism.sh after the bundle build step. Ensure job runs on same runner and uploads artifacts/logs on failure. Commit the workflow change with message: "ci(bundles): add repeat-build determinism check". - - - grep -n "verify-bundle-determinism" .github/workflows/nodejs.yml || true - - CI workflow updated to run determinism script and committed. - - - - Task 3: Create PLAN summary - .planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md - - Create a short summary file documenting the script, the CI job, verification steps for maintainers, and commit the file. - - - test -f .planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md && echo OK || echo MISSING - - Summary file exists and documents the determinism check and verification steps. Commit created. - - - - - -Run the script locally to validate determinism: ./scripts/verify-bundle-determinism.sh. If outputs differ, investigate build sources that include non-deterministic content (timestamps, hashes, random salts). CI will run the script and fail if mismatches occur. - - - - -- scripts/verify-bundle-determinism.sh exists and is executable -- CI workflow references and runs the script -- 09-PLAN-SUMMARY.md exists and is committed - - - -After completion, create `.planning/phases/01-core-stabilization/09-PLAN-SUMMARY.md` - diff --git a/.planning/phases/01-core-stabilization/CORE-02-AUDIT.md b/.planning/phases/01-core-stabilization/CORE-02-AUDIT.md deleted file mode 100644 index 9e1197bbd8d..00000000000 --- a/.planning/phases/01-core-stabilization/CORE-02-AUDIT.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -phase: 01-core-stabilization -plan: 04 -requirement: CORE-02 ---- - -# CORE-02 Audit: memoize & deepExtend - -## Summary - -This audit locates where CORE-02 (fix issues in engine/src/Utils — memoize, deepExtend) is satisfied in the repository and, where coverage is missing, defines a minimal remediation plan. - -## Findings - -- engine/src/Utils/Utils.ts - - Contains implementations of memoize and deepExtend (search: `memoize` in Utils.ts). - - Notes: code exposes memoize with options and uses stableStringify for deep argument keying. See lines where memoize is defined and exported. - -- utils/tests/src/tests/memoize.test.ts - - Unit tests present that exercise memoize behavior: primitive caching, deep-object keying, maxSize eviction, and TTL handling. - - These tests import memoize from the engine package and provide direct coverage of CORE-02 behaviors. - -## Evidence & Mappings - -- engine/src/Utils/Utils.ts -> memoize implementation - - Evidence: export of memoize, use sites in engine codebase (e.g., getFullScreenStyle uses memoize). See `engine/src/Utils/Utils.ts` references. - -- utils/tests/src/tests/memoize.test.ts -> tests covering memoize - - Evidence: tests assert cache hits, TTL, and eviction behavior. These satisfy the behavioral expectations of CORE-02 at the artifact level. - -## Conclusion - -At the artifact level, CORE-02 is satisfied: implementations and unit tests for memoize and deepExtend exist and are substantive. The remaining verification required is to run the tests in CI and ensure they pass in the target environments (Node + jsdom where applicable). - -## Remediation Plan (if CI/tests not run here) - -If test execution in CI is missing or flakey, perform the following minimal remediation tasks (TDD-style) to ensure CORE-02 is verifiable and robust: - -1. Task: Add/extend failing tests for missing edge-cases (if any) - - Test file: utils/tests/src/tests/memoize.edge.test.ts - - Implementation under test: engine/src/Utils/Utils.ts (memoize) - - Acceptance criteria: tests demonstrate correct eviction when maxSize is reached, correct expiry with ttlMs, and no regression for memoize(fn) callers. - - Estimated Claude execution time: 20-40 minutes - -2. Task: CI integration check - - Action: Ensure utils/tests target is included in CI (workflow or nx cloud affected target). If not present, add a CI entry referencing `pnpm --filter @tsparticles/tests test -- "utils/tests/src/tests/memoize.test.ts"`. - - Acceptance: Tests run in CI and pass; CI artifacts show test results. - - Estimated Claude execution time: 10-20 minutes (automation), manual CI update may be needed. - -## Files referenced (examples) - -- engine/src/Utils/Utils.ts -- utils/tests/src/tests/memoize.test.ts -- .planning/phases/01-core-stabilization/01-core-01-SUMMARY.md - -If further gaps are found when running tests in CI, open focused remediation plans limited to small TDD tasks (1-2 tests + minimal code change) targeted at the failing assertions. diff --git a/.planning/phases/01-core-stabilization/VERIFICATION.md b/.planning/phases/01-core-stabilization/VERIFICATION.md deleted file mode 100644 index 26ad951c8d2..00000000000 --- a/.planning/phases/01-core-stabilization/VERIFICATION.md +++ /dev/null @@ -1,29 +0,0 @@ -# VERIFICATION REPORT - -Checked plans in: .planning/phases/01-core-stabilization - -## 05-PLAN.md - -- STATUS: frontmatter restored in follow-up (see commit f61cda7c9e) - -# Requirement coverage - -- CORE-01: FOUND in: - - 01-PLAN.md -- CORE-02: FOUND in: - - 04-PLAN.md -- TEST-01: FOUND in: - - 03-PLAN.md - -## VERIFICATION RESULT - -## ISSUES FOUND - -Total issues: 1 - -## HUMAN CHECKPOINT - -- Human verification response: approved -- Approved at: 2026-03-03T10:22:45Z - -(Note: The planner originally detected a missing frontmatter for 05-PLAN.md. This gap plan (06) restored the required YAML frontmatter and committed the change (commit f61cda7c9e). Re-run plan-checker if available to confirm no remaining parse errors.) diff --git a/.planning/phases/01-fix-tests/01-fix-tests-SUMMARY.md b/.planning/phases/01-fix-tests/01-fix-tests-SUMMARY.md deleted file mode 100644 index 8c31b2ac224..00000000000 --- a/.planning/phases/01-fix-tests/01-fix-tests-SUMMARY.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -phase: 01-fix-tests -plan: 01 -status: completed -verified: 2026-03-01T21:05:00Z ---- - -# Summary — Fix tests: remove unsupported --threads flag - -What I changed - -- Updated utils/tests/package.json test:ci script to remove unsupported `--threads` option. New value: `NODE_ENV=test vitest run --maxConcurrency=2`. - -Why - -- Vitest CLI rejected `--threads` (CACError: Unknown option `--threads`). Removing it allows the test runner to start; concurrency remains controlled via `--maxConcurrency`. - -Verification - -- Executed: `pnpm --filter @tsparticles/tests run test:ci` from repo root. -- Result: Vitest started and ran 8 test files; 136 tests passed. Coverage report printed with v8 provider. - -Next steps - -- Consider searching the monorepo for other occurrences of `--threads` and update similarly (done in this plan). -- Optionally update ROADMAP/STATE to mark phase work complete. - -Log - -- 2026-03-01T21:00Z — Edited utils/tests/package.json, removed `--threads`. -- 2026-03-01T21:02Z — Ran pnpm script; all tests passed in that package. diff --git a/.planning/phases/02-enum-refactor/01-PLAN.md b/.planning/phases/02-enum-refactor/01-PLAN.md deleted file mode 100644 index bb155bd8c36..00000000000 --- a/.planning/phases/02-enum-refactor/01-PLAN.md +++ /dev/null @@ -1,150 +0,0 @@ ---- -phase: 02-enum-refactor -plan: 01 -type: execute -wave: 1 -depends_on: [] -files_modified: - - engine/src/Enums/Types/EventType.ts - - engine/src/Enums/Modes/OutMode.ts - - engine/src/Enums/Types/StartValueType.ts - - .planning/phases/02-enum-refactor/enum-inventory.md -autonomous: true -requirements: - - CORE-02 - - TEST-01 -user_setup: [] -must_haves: - truths: - - "Replacing small string enums with as-const objects does not change runtime behavior for consumers" - - "Build and tests pass after enum conversions" - - "Public typings remain explicit (no use of `any`) and imports keep the same exported names" - artifacts: - - path: "engine/src/Enums/Types/EventType.ts" - provides: "Event type values available at runtime and a TypeScript type for EventType" - - path: "engine/src/Enums/Modes/OutMode.ts" - provides: "Out mode values exposed as a runtime object and a type alias OutMode" - - path: "engine/src/Enums/Types/StartValueType.ts" - provides: "StartValueType values available as const + Type alias" - - path: ".planning/phases/02-enum-refactor/enum-inventory.md" - provides: "Inventory of all enum files and a conversion recommendation (keep/convert/manual)" - key_links: - - from: "engine/src/Enums/Types/EventType.ts" - to: "engine code that imports EventType" - via: "named import -> use EventType.X pattern" - pattern: "import .*EventType.*" - - from: "engine/src/Enums/Modes/OutMode.ts" - to: "updaters/outModes implementations" - via: "imports and string comparison/switch" - pattern: "OutMode\.|OutMode =" - ---- - - -Replace a small, low-risk set of string-valued TypeScript enums with type-safe `as const` objects + derived union types to reduce emitted JS and improve tree-shaking. Start with a narrow, auditable pilot (3 files) and produce an inventory for follow-ups. - -Purpose: reduce unnecessary enum runtime objects (bundle size risk) while preserving API/typing and keeping changes small and reversible. -Output: inventory file and converted implementations for EventType, OutMode, StartValueType plus verification steps. - - - -Repository conventions (from .planning and AGENTS.md): TypeScript monorepo, prefer explicit types for public APIs, run tests with Vitest and builds with pnpm scripts. Keep changes small and include tests. - -Key enum files (pilot): - -- engine/src/Enums/Types/EventType.ts -- engine/src/Enums/Modes/OutMode.ts -- engine/src/Enums/Types/StartValueType.ts - -The codebase contains many string enums across engine and plugins. This plan audits and converts a small, low-risk subset first. - - - - - - Task 1: Audit — enumerate all TypeScript enums and classify - .planning/phases/02-enum-refactor/enum-inventory.md - - Run a repo-wide scan for `export enum` and produce a markdown inventory listing: file path, number of members, member names, and a quick recommendation: `convert` (small string enum, used only as values/types), `keep` (numeric enum or bit-flags or large enums with reverse mapping), or `manual` (large enums with many cross-package usages). Save output to `.planning/phases/02-enum-refactor/enum-inventory.md`. - - Implementation notes for executor (automated): prefer ripgrep (rg) or git-grep. Include a short grep command and summary header. Don't modify source files in this task. - - - - rg --hidden "export enum" --glob '!node_modules' --glob '!.git' -n || true - rg --hidden "export enum" --glob '!node_modules' --glob '!.git' -n > .planning/phases/02-enum-refactor/enum-inventory.md && test -s .planning/phases/02-enum-refactor/enum-inventory.md - - The file `.planning/phases/02-enum-refactor/enum-inventory.md` exists and contains a line per enum with path, member count and an initial recommendation (convert/keep/manual). - - - - Task 2: Convert pilot enums to `as const` + derived type - - engine/src/Enums/Types/EventType.ts, - engine/src/Enums/Modes/OutMode.ts, - engine/src/Enums/Types/StartValueType.ts - - - For each listed file, replace the `export enum X { a = "a", ... }` pattern with an exported const object and a derived union type. Example transform: - - Before: - export enum EventType { configAdded = "configAdded", ... } - - After: - export const EventType = { - configAdded: "configAdded", - ... - } as const; - - export type EventType = typeof EventType[keyof typeof EventType]; - - Implementation details: - - Keep the named export `EventType` so existing `import { EventType } from "..."` still works at runtime for consumers that relied on the object. (Note: this changes the runtime shape from enum object to plain object — property access `EventType.configAdded` remains.) - - Run a repo-wide typecheck/build after changes to catch uses that assume numeric reverse-mapping or enum-specific operations. If code relies on numeric enum behavior or reverse mapping, mark the enum in the inventory as `keep` and revert changes for that file. - - Put a small comment above the converted object explaining the reason and linking to the inventory entry (for reviewers). - - Commit changes in a single atomic change per file (executor will create commits). Do not push. - - - - pnpm -s run -w build || pnpm -s run build - - - Each pilot file now exports a const object + derived type; `pnpm run build` completes without type errors. If any file caused type errors due to enum-specific usage, it has been reverted and noted in inventory. - - - - Task 3: Sanity checks — run tests, run a minimal bundle check - package.json - - Run the test suite and a slim build to ensure there are no runtime regressions. Commands to run: - - `pnpm exec vitest run` (run test suites) - - `pnpm run slimbuild` (build slim bundles) - - If tests fail, capture failing test names and revert the specific enum changes that caused regressions (one-by-one) and document in the inventory. - - - - pnpm exec vitest run --reporter dot && pnpm run slimbuild - - All tests pass (Vitest exit 0) and `pnpm run slimbuild` completes. If failures occurred, they are documented in `.planning/phases/02-enum-refactor/enum-inventory.md` with per-file revert notes. - - - - - -Overall checks: -- `.planning/phases/02-enum-refactor/enum-inventory.md` exists and lists all enums found with a recommendation column. -- The three pilot files have been replaced with `as const` objects + derived types OR explicitly marked `keep` in the inventory with rationale. -- `pnpm run build` and `pnpm exec vitest run` both succeed after changes, or failing conversions were reverted and recorded. - - - - -- Inventory created and reviewed: `.planning/phases/02-enum-refactor/enum-inventory.md` present. -- At least the three pilot enums converted with passing build and tests. -- No public API behavior regressions for consumers of the converted enums (property access preserved). - - - -After completion, create `.planning/phases/02-enum-refactor/01-PLAN-SUMMARY.md` summarizing converted enums and any reverts. - diff --git a/.planning/phases/02-enum-refactor/enum-inventory.md b/.planning/phases/02-enum-refactor/enum-inventory.md deleted file mode 100644 index 9fdf4621da2..00000000000 --- a/.planning/phases/02-enum-refactor/enum-inventory.md +++ /dev/null @@ -1,39 +0,0 @@ -engine/src/Enums/AnimationStatus.ts:1:export enum AnimationStatus { -engine/src/Enums/Directions/MoveDirection.ts:3:export enum MoveDirection { -engine/src/Enums/Directions/OutModeDirection.ts:1:export enum OutModeDirection { -engine/src/Enums/Directions/RotateDirection.ts:3:export enum RotateDirection { -engine/src/Enums/Modes/AnimationMode.ts:1:export enum AnimationMode { -engine/src/Enums/Modes/LimitMode.ts:1:export enum LimitMode { -engine/src/Enums/Modes/OutMode.ts:3:export enum OutMode { -engine/src/Enums/Modes/PixelMode.ts:3:export enum PixelMode { -engine/src/Enums/RangeType.ts:1:export enum RangeType { -engine/src/Enums/Types/AlterType.ts:1:export enum AlterType { -engine/src/Enums/Types/DestroyType.ts:3:export enum DestroyType { -engine/src/Enums/Types/EasingType.ts:1:export enum EasingType { -engine/src/Enums/Types/EventType.ts:1:export enum EventType { -engine/src/Enums/Types/GradientType.ts:1:export enum GradientType { -engine/src/Enums/Types/ParticleOutType.ts:1:export enum ParticleOutType { -engine/src/Enums/Types/StartValueType.ts:3:export enum StartValueType { -interactions/external/bubble/src/Enums.ts:3:export enum ProcessBubbleType { -interactions/particles/collisions/src/CollisionMode.ts:3:export enum CollisionMode { -paths/spiral/src/SpiralDirection.ts:1:export enum SpiralDirection { -plugins/emitters/src/Enums/EmitterClickMode.ts:3:export enum EmitterClickMode { -plugins/interactivity/src/Enums/DivType.ts:3:export enum DivType { -plugins/interactivity/src/Enums/InteractivityDetect.ts:3:export enum InteractivityDetect { -plugins/interactivity/src/Enums/InteractorType.ts:1:export enum InteractorType { -plugins/polygonMask/src/Enums/PolygonMaskInlineArrangement.ts:1:export enum PolygonMaskInlineArrangement { -plugins/polygonMask/src/Enums/PolygonMaskMoveType.ts:1:export enum PolygonMaskMoveType { -plugins/polygonMask/src/Enums/PolygonMaskType.ts:1:export enum PolygonMaskType { -plugins/responsive/src/ResponsiveMode.ts:1:export enum ResponsiveMode { -plugins/sounds/src/enums.ts:1:export enum SoundsEventType { -plugins/sounds/src/enums.ts:6:export enum ImageDisplay { -plugins/themes/src/ThemeMode.ts:1:export enum ThemeMode { -shapes/cards/src/CardValue.ts:1:export enum CardValue { -shapes/cards/src/SuitType.ts:1:export enum SuitType { -shapes/image/src/GifUtils/Enums/DisposalMethod.ts:1:export enum DisposalMethod { -shapes/image/src/GifUtils/Types/GIFDataHeaders.ts:1:export enum GIFDataHeaders { -updaters/destroy/src/Enums/DestroyMode.ts:1:export enum DestroyMode { -updaters/orbit/src/Enums.ts:1:export enum OrbitType { -updaters/roll/src/RollMode.ts:1:export enum RollMode { -updaters/tilt/src/TiltDirection.ts:3:export enum TiltDirection { -utils/pathUtils/src/SegmentType.ts:1:export enum SegmentType { diff --git a/.planning/research/ARCHITECTURE.md b/.planning/research/ARCHITECTURE.md index ad90f61f798..19735cb0720 100644 --- a/.planning/research/ARCHITECTURE.md +++ b/.planning/research/ARCHITECTURE.md @@ -1,20 +1,3 @@ -# Research — Architecture (synthesized) +ARCHITECTURE Research (inferred) -**Analysis Date:** 2026-03-01 - -Component boundaries (based on repo layout): - -- Core Engine (`engine/`) — runtime, utilities, public exports. -- Feature packages (`shapes/`, `updaters/`, `plugins/`) — independent packages that register with engine hooks. -- Bundles (`bundles/*/`) — assembly layer that composes engine + features into publishable artifacts. -- Demos (`demo/`) — example apps and demo server. - -Data flow & build order - -1. Feature packages implement a registration contract and export entry files (`src/index.ts`). -2. Bundles import and register selected features during bundle assembly (`bundles/*/src/bundle.ts`). -3. CI builds packages (nx run-many) and publishes via publish scripts. - -Where to extend - -- Add features as top-level packages following the established `src/index.ts` pattern and register them in `bundles/*/src/bundle.ts` when publishing. +High-level architecture notes already exist in `.planning/codebase/ARCHITECTURE.md`. Research synthesizers can expand this into phase-specific recommendations. diff --git a/.planning/research/FEATURES.md b/.planning/research/FEATURES.md index ae0eb0c2a70..3cc2663f1b4 100644 --- a/.planning/research/FEATURES.md +++ b/.planning/research/FEATURES.md @@ -1,24 +1,3 @@ -# Research — Features (synthesized) +FEATURES Research (inferred) -**Analysis Date:** 2026-03-01 - -Table stakes (what users expect from a particle engine library): - -- Stable core runtime with predictable lifecycle and API (`engine/src/exports.ts`). -- A set of feature modules (shapes, updaters, plugins) that are easy to register with the engine. -- Bundles that provide minimal, slim, and full builds for different footprint needs (`bundles/*`). -- Documentation and examples/demos to help adoption (`demo/vanilla`). - -Differentiators (nice-to-have): - -- Lightweight slim bundle optimized for minimal bytes. -- A curated set of performant, mobile-friendly shapes/updaters. - -Anti-features (deliberately excluded for v1): - -- Server-side real-time features or heavy analytics — out of scope. - -Complexity notes - -- Publishing multiple bundles adds CI complexity (lerna + nx orchestration). -- Tests involving canvas and jsdom are sensitive; expect flaky behavior without careful isolation. +Table stakes and differentiators for a particle engine library are documented in `.planning/codebase/INTEGRATIONS.md` and `.planning/codebase/STRUCTURE.md`. Detailed feature research deferred. diff --git a/.planning/research/PITFALLS.md b/.planning/research/PITFALLS.md index e349e95b625..d5fb5384cd0 100644 --- a/.planning/research/PITFALLS.md +++ b/.planning/research/PITFALLS.md @@ -1,16 +1,3 @@ -# Research — Pitfalls (synthesized) +PITFALLS Research (inferred) -**Analysis Date:** 2026-03-01 - -Common mistakes and warnings observed in this codebase type: - -- Mixing global state and `globalThis` exposure (search: `engine/src/index.ts`) — risk of collisions in host pages and tests. -- Heavy per-frame allocations in hot loops — profile `engine/src/Core/Particles.ts` under realistic particle counts. -- Unbounded memoize/cache patterns (see `engine/src/Utils/Utils.ts`) — potential memory growth. -- Flaky canvas tests due to environment differences (jsdom + canvas). Keep deterministic fixtures. - -Prevention strategies - -- Avoid mutating `globalThis` by default; provide opt-in bootstrapping. -- Add benchmarks and object pooling strategies for hot paths. -- Replace ad-hoc memoize with bounded caches and clear TTL/size limits. +Common pitfalls (performance hot paths, bundle drift, publish mistakes) are documented in `.planning/codebase/CONCERNS.md`. Deeper research can add signals and prevention strategies. diff --git a/.planning/research/STACK.md b/.planning/research/STACK.md index 0ad0e53a6d2..b2fa0e2429d 100644 --- a/.planning/research/STACK.md +++ b/.planning/research/STACK.md @@ -1,35 +1,3 @@ -# Research — Stack (synthesized) +STACK Research (inferred) -**Analysis Date:** 2026-03-01 - -Summary of recommended and existing stack choices based on repository inspection. - -Languages & Runtimes - -- TypeScript (primary, pinned to ^5.9.x in root `package.json`) -- Node.js for CI and tooling (CI uses Node 24 in `.github/workflows/nodejs.yml`) - -Package Management & Orchestration - -- pnpm workspace (`pnpm-workspace.yaml`) with `pnpm-lock.yaml` -- Nx for task orchestration and affected builds (`nx.json`) -- Lerna used for publish scripts (`lerna` in root `package.json` scripts) - -Build & Bundling - -- Webpack is used for bundle builds in `bundles/*/webpack.config.js`. -- SWC loader / terser used for minification in build pipelines. - -Testing & Docs - -- Vitest for unit tests (`utils/tests/`) -- Typedoc for API docs generation (`typedoc.json`, `deploy.docs-json.js`) - -CI / Publishing - -- GitHub Actions drive CI and publish flows (`.github/workflows/*`). -- Nx Cloud integration expected (secrets: `NX_CLOUD_ACCESS_TOKEN`). - -Notes - -- This stack is mature for library development. Key operational dependencies are CI secrets and maintaining pinned devDependency versions. +See `.planning/codebase/STACK.md` for current workspace tech choices. Research step deferred to explicit researcher agents; placeholder created during auto-init. diff --git a/AGENTS.md b/AGENTS.md index f184a7ad413..8b517cb1604 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,7 +8,7 @@ This repository uses a pnpm + Nx TypeScript monorepo structure. The guidance bel - Install dependencies: `pnpm i` - Build all packages: `pnpm run build` (runs `slimbuild` + docs) -- Build affected packages: `pnpm run build:affected` or `npx nx affected -t build` +- Build affected packages: `pnpm run build:affected` or `pnpm nx affected -t build` - Run the full workspace build (CI): `pnpm run build:ci` - Run typedoc (docs): `pnpm run build:docs` - Start demo server: `cd demo/vanilla && pnpm start` @@ -17,17 +17,17 @@ This repository uses a pnpm + Nx TypeScript monorepo structure. The guidance bel - Format README + markdown: `pnpm run prettify:readme` - Check formatting (CI): `pnpm run prettify:ci:readme` -- Run ESLint (package-local): `npx nx run :lint` or `pnpm --filter run lint` +- Run ESLint (package-local): `pnpm nx run :lint` or `pnpm --filter run lint` - Husky hooks are enabled: local `git commit` runs hooks (`prepare` script in `package.json`). Do not bypass hooks. ## Tests -- Run all tests (workspace): `pnpm exec vitest` or `npx nx run-many -t test` +- Run all tests (workspace): `pnpm exec vitest` or `pnpm nx run-many -t test` - Run package tests (example): `pnpm --filter @tsparticles/tests test` - Run a single test file with Vitest: - From package: `pnpm --filter @tsparticles/tests test:particle` (predefined script) - Directly: `pnpm exec vitest run path/to/test/file.ts` (e.g. `utils/tests/src/tests/Particle.ts`) - - With Nx (project-level): `npx nx test --testFile=src/tests/Particle.ts` (use project-specific options) + - With Nx (project-level): `pnpm nx test --testFile=src/tests/Particle.ts` (use project-specific options) - Run tests in watch UI: `pnpm --filter @tsparticles/tests test:ui` or `pnpm exec vitest --ui` - Coverage: vitest with v8 provider configured in `utils/tests/vitest.config.ts` — CI exposes coverage artifacts under `utils/tests/coverage/`. @@ -124,11 +124,24 @@ PRs - Cursor skills & rules found under `.cursor/`: follow the skill definitions before invoking local helpers. Notable files: - `.cursor/skills/monitor-ci/SKILL.md` + - `.cursor/skills/link-workspace-packages/SKILL.md` - `.cursor/skills/nx-workspace/SKILL.md` - `.cursor/skills/nx-generate/SKILL.md` + - `.cursor/skills/nx-import/SKILL.md` - `.cursor/skills/nx-run-tasks/SKILL.md` - `.cursor/skills/nx-plugins/SKILL.md` +- Equivalent GitHub Copilot assets are also present under `.github/`: + - `.github/skills/monitor-ci/SKILL.md` + - `.github/skills/link-workspace-packages/SKILL.md` + - `.github/skills/nx-workspace/SKILL.md` + - `.github/skills/nx-generate/SKILL.md` + - `.github/skills/nx-import/SKILL.md` + - `.github/skills/nx-run-tasks/SKILL.md` + - `.github/skills/nx-plugins/SKILL.md` + - `.github/agents/ci-monitor-subagent.agent.md` + - `.github/prompts/monitor-ci.prompt.md` + - There is no `.github/copilot-instructions.md` present; follow the repository linting and commit rules instead. --- diff --git a/CHANGELOG.md b/CHANGELOG.md index 48bed65c687..7e888a72c51 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,22 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Bug Fixes + +- improved trail drawer outcome a bit ([4f5368f](https://github.com/tsparticles/tsparticles/commit/4f5368ff0b404a6c3a440b23020b2ba78eb8e17b)) +- improved trail drawer outcome a bit ([90154ac](https://github.com/tsparticles/tsparticles/commit/90154acc3322bdc4c1f5d40eda1bea3688c2d60a)) +- improved trail drawer performance a bit ([8a28709](https://github.com/tsparticles/tsparticles/commit/8a28709e00f524fcd65bd54d6194e60b9c60845d)) +- reduced checks on trail drawing ([2cc5614](https://github.com/tsparticles/tsparticles/commit/2cc5614c96f0d8f8fa4b4a7c3f882df2778e4cf5)) +- reduced checks on trail drawing ([c1201d2](https://github.com/tsparticles/tsparticles/commit/c1201d24560ed60b49b560ab1ac6950c0b074e58)) + +### Features + +- added drag & drop interaction external (mouse click) ([87ac189](https://github.com/tsparticles/tsparticles/commit/87ac189240ded4d3055d145fa7453bc9c17b1d82)) +- added momentum option to drag & drop interactor ([12d3696](https://github.com/tsparticles/tsparticles/commit/12d3696376d98c9000ff73cd518b1eae268a59b4)) +- **roadmap:** replace roadmap with single drag-drop phase; add phase context ([47051de](https://github.com/tsparticles/tsparticles/commit/47051de07a088765929d530b3427b5bf2ffd7742)) + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) ### Bug Fixes diff --git a/bundles/all/CHANGELOG.md b/bundles/all/CHANGELOG.md index 86e234d3f39..3f2c507d484 100644 --- a/bundles/all/CHANGELOG.md +++ b/bundles/all/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/all + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/all diff --git a/bundles/all/package.dist.json b/bundles/all/package.dist.json index 0bfdd2ad4a8..97266920351 100644 --- a/bundles/all/package.dist.json +++ b/bundles/all/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/all", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,82 +99,82 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/effect-bubble": "4.0.0-alpha.28", - "@tsparticles/effect-particles": "4.0.0-alpha.28", - "@tsparticles/effect-shadow": "4.0.0-alpha.28", - "@tsparticles/effect-trail": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/interaction-external-particle": "4.0.0-alpha.28", - "@tsparticles/interaction-external-pop": "4.0.0-alpha.28", - "@tsparticles/interaction-light": "4.0.0-alpha.28", - "@tsparticles/interaction-particles-repulse": "4.0.0-alpha.28", - "@tsparticles/path-branches": "4.0.0-alpha.28", - "@tsparticles/path-brownian": "4.0.0-alpha.28", - "@tsparticles/path-curl-noise": "4.0.0-alpha.28", - "@tsparticles/path-curves": "4.0.0-alpha.28", - "@tsparticles/path-fractal-noise": "4.0.0-alpha.28", - "@tsparticles/path-grid": "4.0.0-alpha.28", - "@tsparticles/path-levy": "4.0.0-alpha.28", - "@tsparticles/path-perlin-noise": "4.0.0-alpha.28", - "@tsparticles/path-polygon": "4.0.0-alpha.28", - "@tsparticles/path-random": "4.0.0-alpha.28", - "@tsparticles/path-simplex-noise": "4.0.0-alpha.28", - "@tsparticles/path-spiral": "4.0.0-alpha.28", - "@tsparticles/path-svg": "4.0.0-alpha.28", - "@tsparticles/path-zig-zag": "4.0.0-alpha.28", - "@tsparticles/plugin-background-mask": "4.0.0-alpha.28", - "@tsparticles/plugin-blend": "4.0.0-alpha.28", - "@tsparticles/plugin-canvas-mask": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-back": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-bounce": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-circ": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-cubic": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-elastic": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-expo": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-gaussian": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-linear": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-quart": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-quint": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-sigmoid": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-sine": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-smoothstep": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-canvas": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-path": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-polygon": "4.0.0-alpha.28", - "@tsparticles/plugin-export-image": "4.0.0-alpha.28", - "@tsparticles/plugin-export-json": "4.0.0-alpha.28", - "@tsparticles/plugin-export-video": "4.0.0-alpha.28", - "@tsparticles/plugin-hsv-color": "4.0.0-alpha.28", - "@tsparticles/plugin-hwb-color": "4.0.0-alpha.28", - "@tsparticles/plugin-infection": "4.0.0-alpha.28", - "@tsparticles/plugin-lab-color": "4.0.0-alpha.28", - "@tsparticles/plugin-lch-color": "4.0.0-alpha.28", - "@tsparticles/plugin-manual-particles": "4.0.0-alpha.28", - "@tsparticles/plugin-motion": "4.0.0-alpha.28", - "@tsparticles/plugin-named-color": "4.0.0-alpha.28", - "@tsparticles/plugin-oklab-color": "4.0.0-alpha.28", - "@tsparticles/plugin-oklch-color": "4.0.0-alpha.28", - "@tsparticles/plugin-poisson-disc": "4.0.0-alpha.28", - "@tsparticles/plugin-polygon-mask": "4.0.0-alpha.28", - "@tsparticles/plugin-responsive": "4.0.0-alpha.28", - "@tsparticles/plugin-sounds": "4.0.0-alpha.28", - "@tsparticles/plugin-themes": "4.0.0-alpha.28", - "@tsparticles/plugin-trail": "4.0.0-alpha.28", - "@tsparticles/plugin-zoom": "4.0.0-alpha.28", - "@tsparticles/shape-arrow": "4.0.0-alpha.28", - "@tsparticles/shape-cards": "4.0.0-alpha.28", - "@tsparticles/shape-cog": "4.0.0-alpha.28", - "@tsparticles/shape-heart": "4.0.0-alpha.28", - "@tsparticles/shape-infinity": "4.0.0-alpha.28", - "@tsparticles/shape-matrix": "4.0.0-alpha.28", - "@tsparticles/shape-path": "4.0.0-alpha.28", - "@tsparticles/shape-rounded-polygon": "4.0.0-alpha.28", - "@tsparticles/shape-rounded-rect": "4.0.0-alpha.28", - "@tsparticles/shape-spiral": "4.0.0-alpha.28", - "@tsparticles/shape-squircle": "4.0.0-alpha.28", - "@tsparticles/updater-gradient": "4.0.0-alpha.28", - "@tsparticles/updater-orbit": "4.0.0-alpha.28", - "tsparticles": "4.0.0-alpha.28" + "@tsparticles/effect-bubble": "4.0.0-beta.0", + "@tsparticles/effect-particles": "4.0.0-beta.0", + "@tsparticles/effect-shadow": "4.0.0-beta.0", + "@tsparticles/effect-trail": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/interaction-external-particle": "4.0.0-beta.0", + "@tsparticles/interaction-external-pop": "4.0.0-beta.0", + "@tsparticles/interaction-light": "4.0.0-beta.0", + "@tsparticles/interaction-particles-repulse": "4.0.0-beta.0", + "@tsparticles/path-branches": "4.0.0-beta.0", + "@tsparticles/path-brownian": "4.0.0-beta.0", + "@tsparticles/path-curl-noise": "4.0.0-beta.0", + "@tsparticles/path-curves": "4.0.0-beta.0", + "@tsparticles/path-fractal-noise": "4.0.0-beta.0", + "@tsparticles/path-grid": "4.0.0-beta.0", + "@tsparticles/path-levy": "4.0.0-beta.0", + "@tsparticles/path-perlin-noise": "4.0.0-beta.0", + "@tsparticles/path-polygon": "4.0.0-beta.0", + "@tsparticles/path-random": "4.0.0-beta.0", + "@tsparticles/path-simplex-noise": "4.0.0-beta.0", + "@tsparticles/path-spiral": "4.0.0-beta.0", + "@tsparticles/path-svg": "4.0.0-beta.0", + "@tsparticles/path-zig-zag": "4.0.0-beta.0", + "@tsparticles/plugin-background-mask": "4.0.0-beta.0", + "@tsparticles/plugin-blend": "4.0.0-beta.0", + "@tsparticles/plugin-canvas-mask": "4.0.0-beta.0", + "@tsparticles/plugin-easing-back": "4.0.0-beta.0", + "@tsparticles/plugin-easing-bounce": "4.0.0-beta.0", + "@tsparticles/plugin-easing-circ": "4.0.0-beta.0", + "@tsparticles/plugin-easing-cubic": "4.0.0-beta.0", + "@tsparticles/plugin-easing-elastic": "4.0.0-beta.0", + "@tsparticles/plugin-easing-expo": "4.0.0-beta.0", + "@tsparticles/plugin-easing-gaussian": "4.0.0-beta.0", + "@tsparticles/plugin-easing-linear": "4.0.0-beta.0", + "@tsparticles/plugin-easing-quart": "4.0.0-beta.0", + "@tsparticles/plugin-easing-quint": "4.0.0-beta.0", + "@tsparticles/plugin-easing-sigmoid": "4.0.0-beta.0", + "@tsparticles/plugin-easing-sine": "4.0.0-beta.0", + "@tsparticles/plugin-easing-smoothstep": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-canvas": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-path": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-polygon": "4.0.0-beta.0", + "@tsparticles/plugin-export-image": "4.0.0-beta.0", + "@tsparticles/plugin-export-json": "4.0.0-beta.0", + "@tsparticles/plugin-export-video": "4.0.0-beta.0", + "@tsparticles/plugin-hsv-color": "4.0.0-beta.0", + "@tsparticles/plugin-hwb-color": "4.0.0-beta.0", + "@tsparticles/plugin-infection": "4.0.0-beta.0", + "@tsparticles/plugin-lab-color": "4.0.0-beta.0", + "@tsparticles/plugin-lch-color": "4.0.0-beta.0", + "@tsparticles/plugin-manual-particles": "4.0.0-beta.0", + "@tsparticles/plugin-motion": "4.0.0-beta.0", + "@tsparticles/plugin-named-color": "4.0.0-beta.0", + "@tsparticles/plugin-oklab-color": "4.0.0-beta.0", + "@tsparticles/plugin-oklch-color": "4.0.0-beta.0", + "@tsparticles/plugin-poisson-disc": "4.0.0-beta.0", + "@tsparticles/plugin-polygon-mask": "4.0.0-beta.0", + "@tsparticles/plugin-responsive": "4.0.0-beta.0", + "@tsparticles/plugin-sounds": "4.0.0-beta.0", + "@tsparticles/plugin-themes": "4.0.0-beta.0", + "@tsparticles/plugin-trail": "4.0.0-beta.0", + "@tsparticles/plugin-zoom": "4.0.0-beta.0", + "@tsparticles/shape-arrow": "4.0.0-beta.0", + "@tsparticles/shape-cards": "4.0.0-beta.0", + "@tsparticles/shape-cog": "4.0.0-beta.0", + "@tsparticles/shape-heart": "4.0.0-beta.0", + "@tsparticles/shape-infinity": "4.0.0-beta.0", + "@tsparticles/shape-matrix": "4.0.0-beta.0", + "@tsparticles/shape-path": "4.0.0-beta.0", + "@tsparticles/shape-rounded-polygon": "4.0.0-beta.0", + "@tsparticles/shape-rounded-rect": "4.0.0-beta.0", + "@tsparticles/shape-spiral": "4.0.0-beta.0", + "@tsparticles/shape-squircle": "4.0.0-beta.0", + "@tsparticles/updater-gradient": "4.0.0-beta.0", + "@tsparticles/updater-orbit": "4.0.0-beta.0", + "tsparticles": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/all/package.json b/bundles/all/package.json index a36c1ce8db3..86a4db7feaa 100644 --- a/bundles/all/package.json +++ b/bundles/all/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/all", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,82 +107,82 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/effect-bubble": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-particles": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-shadow": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-particle": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-pop": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-light": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-alpha.28", - "@tsparticles/path-branches": "workspace:4.0.0-alpha.28", - "@tsparticles/path-brownian": "workspace:4.0.0-alpha.28", - "@tsparticles/path-curl-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-curves": "workspace:4.0.0-alpha.28", - "@tsparticles/path-fractal-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-grid": "workspace:4.0.0-alpha.28", - "@tsparticles/path-levy": "workspace:4.0.0-alpha.28", - "@tsparticles/path-perlin-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/path-random": "workspace:4.0.0-alpha.28", - "@tsparticles/path-simplex-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-spiral": "workspace:4.0.0-alpha.28", - "@tsparticles/path-svg": "workspace:4.0.0-alpha.28", - "@tsparticles/path-zig-zag": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-background-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-blend": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-canvas-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-back": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-bounce": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-circ": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-cubic": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-elastic": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-expo": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-gaussian": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-linear": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quart": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quint": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-sigmoid": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-sine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-smoothstep": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-canvas": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-path": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-image": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-json": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-video": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsv-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hwb-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-infection": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-lab-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-lch-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-manual-particles": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-motion": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-named-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-oklab-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-oklch-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-poisson-disc": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-polygon-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-responsive": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-sounds": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-themes": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-zoom": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-arrow": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-cards": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-cog": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-heart": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-infinity": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-matrix": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-path": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-rounded-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-rounded-rect": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-spiral": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-squircle": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-gradient": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-orbit": "workspace:4.0.0-alpha.28", - "tsparticles": "workspace:4.0.0-alpha.28" + "@tsparticles/effect-bubble": "workspace:4.0.0-beta.0", + "@tsparticles/effect-particles": "workspace:4.0.0-beta.0", + "@tsparticles/effect-shadow": "workspace:4.0.0-beta.0", + "@tsparticles/effect-trail": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-particle": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-pop": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-light": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-beta.0", + "@tsparticles/path-branches": "workspace:4.0.0-beta.0", + "@tsparticles/path-brownian": "workspace:4.0.0-beta.0", + "@tsparticles/path-curl-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-curves": "workspace:4.0.0-beta.0", + "@tsparticles/path-fractal-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-grid": "workspace:4.0.0-beta.0", + "@tsparticles/path-levy": "workspace:4.0.0-beta.0", + "@tsparticles/path-perlin-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/path-random": "workspace:4.0.0-beta.0", + "@tsparticles/path-simplex-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-spiral": "workspace:4.0.0-beta.0", + "@tsparticles/path-svg": "workspace:4.0.0-beta.0", + "@tsparticles/path-zig-zag": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-background-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-blend": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-canvas-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-back": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-bounce": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-circ": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-cubic": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-elastic": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-expo": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-gaussian": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-linear": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quart": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quint": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-sigmoid": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-sine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-smoothstep": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-canvas": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-path": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-image": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-json": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-video": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsv-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hwb-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-infection": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-lab-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-lch-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-manual-particles": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-motion": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-named-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-oklab-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-oklch-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-poisson-disc": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-polygon-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-responsive": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-sounds": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-themes": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-trail": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-zoom": "workspace:4.0.0-beta.0", + "@tsparticles/shape-arrow": "workspace:4.0.0-beta.0", + "@tsparticles/shape-cards": "workspace:4.0.0-beta.0", + "@tsparticles/shape-cog": "workspace:4.0.0-beta.0", + "@tsparticles/shape-heart": "workspace:4.0.0-beta.0", + "@tsparticles/shape-infinity": "workspace:4.0.0-beta.0", + "@tsparticles/shape-matrix": "workspace:4.0.0-beta.0", + "@tsparticles/shape-path": "workspace:4.0.0-beta.0", + "@tsparticles/shape-rounded-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/shape-rounded-rect": "workspace:4.0.0-beta.0", + "@tsparticles/shape-spiral": "workspace:4.0.0-beta.0", + "@tsparticles/shape-squircle": "workspace:4.0.0-beta.0", + "@tsparticles/updater-gradient": "workspace:4.0.0-beta.0", + "@tsparticles/updater-orbit": "workspace:4.0.0-beta.0", + "tsparticles": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/basic/CHANGELOG.md b/bundles/basic/CHANGELOG.md index 9c084b0a94b..627476e78ca 100644 --- a/bundles/basic/CHANGELOG.md +++ b/bundles/basic/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/basic + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/basic diff --git a/bundles/basic/package.dist.json b/bundles/basic/package.dist.json index 784a24d1d30..58863c4ad4d 100644 --- a/bundles/basic/package.dist.json +++ b/bundles/basic/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/basic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,16 +99,16 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-hex-color": "4.0.0-alpha.28", - "@tsparticles/plugin-hsl-color": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28", - "@tsparticles/plugin-rgb-color": "4.0.0-alpha.28", - "@tsparticles/shape-circle": "4.0.0-alpha.28", - "@tsparticles/updater-fill-color": "4.0.0-alpha.28", - "@tsparticles/updater-opacity": "4.0.0-alpha.28", - "@tsparticles/updater-out-modes": "4.0.0-alpha.28", - "@tsparticles/updater-size": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-hex-color": "4.0.0-beta.0", + "@tsparticles/plugin-hsl-color": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0", + "@tsparticles/plugin-rgb-color": "4.0.0-beta.0", + "@tsparticles/shape-circle": "4.0.0-beta.0", + "@tsparticles/updater-fill-color": "4.0.0-beta.0", + "@tsparticles/updater-opacity": "4.0.0-beta.0", + "@tsparticles/updater-out-modes": "4.0.0-beta.0", + "@tsparticles/updater-size": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/basic/package.json b/bundles/basic/package.json index 1587076fbfd..477f7304dea 100644 --- a/bundles/basic/package.json +++ b/bundles/basic/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/basic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,16 +107,16 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hex-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsl-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-rgb-color": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-circle": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-fill-color": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-opacity": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-out-modes": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-size": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hex-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsl-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-rgb-color": "workspace:4.0.0-beta.0", + "@tsparticles/shape-circle": "workspace:4.0.0-beta.0", + "@tsparticles/updater-fill-color": "workspace:4.0.0-beta.0", + "@tsparticles/updater-opacity": "workspace:4.0.0-beta.0", + "@tsparticles/updater-out-modes": "workspace:4.0.0-beta.0", + "@tsparticles/updater-size": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/confetti/CHANGELOG.md b/bundles/confetti/CHANGELOG.md index 721c9f0db4e..d13804347ac 100644 --- a/bundles/confetti/CHANGELOG.md +++ b/bundles/confetti/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/confetti + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/confetti diff --git a/bundles/confetti/package.dist.json b/bundles/confetti/package.dist.json index 771b6e84672..e637f3bd8de 100644 --- a/bundles/confetti/package.dist.json +++ b/bundles/confetti/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/confetti", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,22 +99,22 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/basic": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28", - "@tsparticles/plugin-motion": "4.0.0-alpha.28", - "@tsparticles/shape-cards": "4.0.0-alpha.28", - "@tsparticles/shape-emoji": "4.0.0-alpha.28", - "@tsparticles/shape-heart": "4.0.0-alpha.28", - "@tsparticles/shape-image": "4.0.0-alpha.28", - "@tsparticles/shape-polygon": "4.0.0-alpha.28", - "@tsparticles/shape-square": "4.0.0-alpha.28", - "@tsparticles/shape-star": "4.0.0-alpha.28", - "@tsparticles/updater-life": "4.0.0-alpha.28", - "@tsparticles/updater-roll": "4.0.0-alpha.28", - "@tsparticles/updater-rotate": "4.0.0-alpha.28", - "@tsparticles/updater-tilt": "4.0.0-alpha.28", - "@tsparticles/updater-wobble": "4.0.0-alpha.28" + "@tsparticles/basic": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0", + "@tsparticles/plugin-motion": "4.0.0-beta.0", + "@tsparticles/shape-cards": "4.0.0-beta.0", + "@tsparticles/shape-emoji": "4.0.0-beta.0", + "@tsparticles/shape-heart": "4.0.0-beta.0", + "@tsparticles/shape-image": "4.0.0-beta.0", + "@tsparticles/shape-polygon": "4.0.0-beta.0", + "@tsparticles/shape-square": "4.0.0-beta.0", + "@tsparticles/shape-star": "4.0.0-beta.0", + "@tsparticles/updater-life": "4.0.0-beta.0", + "@tsparticles/updater-roll": "4.0.0-beta.0", + "@tsparticles/updater-rotate": "4.0.0-beta.0", + "@tsparticles/updater-tilt": "4.0.0-beta.0", + "@tsparticles/updater-wobble": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/confetti/package.json b/bundles/confetti/package.json index e0aa2a0c097..aa86cce94e1 100644 --- a/bundles/confetti/package.json +++ b/bundles/confetti/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/confetti", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,22 +107,22 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/basic": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-motion": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-cards": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-emoji": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-heart": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-image": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-star": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-life": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-roll": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-rotate": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-tilt": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-wobble": "workspace:4.0.0-alpha.28" + "@tsparticles/basic": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-motion": "workspace:4.0.0-beta.0", + "@tsparticles/shape-cards": "workspace:4.0.0-beta.0", + "@tsparticles/shape-emoji": "workspace:4.0.0-beta.0", + "@tsparticles/shape-heart": "workspace:4.0.0-beta.0", + "@tsparticles/shape-image": "workspace:4.0.0-beta.0", + "@tsparticles/shape-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/shape-star": "workspace:4.0.0-beta.0", + "@tsparticles/updater-life": "workspace:4.0.0-beta.0", + "@tsparticles/updater-roll": "workspace:4.0.0-beta.0", + "@tsparticles/updater-rotate": "workspace:4.0.0-beta.0", + "@tsparticles/updater-tilt": "workspace:4.0.0-beta.0", + "@tsparticles/updater-wobble": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/fireworks/CHANGELOG.md b/bundles/fireworks/CHANGELOG.md index 2e317b69a79..8d9309ce063 100644 --- a/bundles/fireworks/CHANGELOG.md +++ b/bundles/fireworks/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/fireworks + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/fireworks diff --git a/bundles/fireworks/package.dist.json b/bundles/fireworks/package.dist.json index 805ba4a23cf..d67907fe88c 100644 --- a/bundles/fireworks/package.dist.json +++ b/bundles/fireworks/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/fireworks", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,15 +99,15 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/basic": "4.0.0-alpha.28", - "@tsparticles/effect-trail": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-square": "4.0.0-alpha.28", - "@tsparticles/plugin-sounds": "4.0.0-alpha.28", - "@tsparticles/updater-destroy": "4.0.0-alpha.28", - "@tsparticles/updater-life": "4.0.0-alpha.28", - "@tsparticles/updater-rotate": "4.0.0-alpha.28" + "@tsparticles/basic": "4.0.0-beta.0", + "@tsparticles/effect-trail": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-square": "4.0.0-beta.0", + "@tsparticles/plugin-sounds": "4.0.0-beta.0", + "@tsparticles/updater-destroy": "4.0.0-beta.0", + "@tsparticles/updater-life": "4.0.0-beta.0", + "@tsparticles/updater-rotate": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/fireworks/package.json b/bundles/fireworks/package.json index 5d514bf3947..95d701428e5 100644 --- a/bundles/fireworks/package.json +++ b/bundles/fireworks/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/fireworks", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,15 +107,15 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/basic": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-sounds": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-destroy": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-life": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-rotate": "workspace:4.0.0-alpha.28" + "@tsparticles/basic": "workspace:4.0.0-beta.0", + "@tsparticles/effect-trail": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-sounds": "workspace:4.0.0-beta.0", + "@tsparticles/updater-destroy": "workspace:4.0.0-beta.0", + "@tsparticles/updater-life": "workspace:4.0.0-beta.0", + "@tsparticles/updater-rotate": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/full/CHANGELOG.md b/bundles/full/CHANGELOG.md index ff206189a50..5b0f343124c 100644 --- a/bundles/full/CHANGELOG.md +++ b/bundles/full/CHANGELOG.md @@ -3,6 +3,12 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Features + +- added drag & drop interaction external (mouse click) ([87ac189](https://github.com/tsparticles/tsparticles/commit/87ac189240ded4d3055d145fa7453bc9c17b1d82)) + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package tsparticles diff --git a/bundles/full/package.dist.json b/bundles/full/package.dist.json index 2743685ac67..81109e4081a 100644 --- a/bundles/full/package.dist.json +++ b/bundles/full/package.dist.json @@ -1,6 +1,6 @@ { "name": "tsparticles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,19 +99,20 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/interaction-external-trail": "4.0.0-alpha.28", - "@tsparticles/plugin-absorbers": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-circle": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-square": "4.0.0-alpha.28", - "@tsparticles/shape-text": "4.0.0-alpha.28", - "@tsparticles/slim": "4.0.0-alpha.28", - "@tsparticles/updater-destroy": "4.0.0-alpha.28", - "@tsparticles/updater-roll": "4.0.0-alpha.28", - "@tsparticles/updater-tilt": "4.0.0-alpha.28", - "@tsparticles/updater-twinkle": "4.0.0-alpha.28", - "@tsparticles/updater-wobble": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/interaction-external-drag": "4.0.0-beta.0", + "@tsparticles/interaction-external-trail": "4.0.0-beta.0", + "@tsparticles/plugin-absorbers": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-circle": "4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-square": "4.0.0-beta.0", + "@tsparticles/shape-text": "4.0.0-beta.0", + "@tsparticles/slim": "4.0.0-beta.0", + "@tsparticles/updater-destroy": "4.0.0-beta.0", + "@tsparticles/updater-roll": "4.0.0-beta.0", + "@tsparticles/updater-tilt": "4.0.0-beta.0", + "@tsparticles/updater-twinkle": "4.0.0-beta.0", + "@tsparticles/updater-wobble": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/full/package.json b/bundles/full/package.json index 9ad63290f8a..d0f14d8e1b7 100644 --- a/bundles/full/package.json +++ b/bundles/full/package.json @@ -1,6 +1,6 @@ { "name": "tsparticles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,19 +107,20 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-absorbers": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-circle": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-text": "workspace:4.0.0-alpha.28", - "@tsparticles/slim": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-destroy": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-roll": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-tilt": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-twinkle": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-wobble": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-drag": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-trail": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-absorbers": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-circle": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/shape-text": "workspace:4.0.0-beta.0", + "@tsparticles/slim": "workspace:4.0.0-beta.0", + "@tsparticles/updater-destroy": "workspace:4.0.0-beta.0", + "@tsparticles/updater-roll": "workspace:4.0.0-beta.0", + "@tsparticles/updater-tilt": "workspace:4.0.0-beta.0", + "@tsparticles/updater-twinkle": "workspace:4.0.0-beta.0", + "@tsparticles/updater-wobble": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/full/src/index.ts b/bundles/full/src/index.ts index 894c370c870..4c040a6bd42 100644 --- a/bundles/full/src/index.ts +++ b/bundles/full/src/index.ts @@ -16,6 +16,7 @@ export async function loadFull(engine: Engine): Promise { await engine.register(async e => { const [ { loadSlim }, + { loadExternalDragInteraction }, { loadExternalTrailInteraction }, { loadAbsorbersPlugin }, { loadEmittersPlugin }, @@ -30,6 +31,7 @@ export async function loadFull(engine: Engine): Promise { ] = await Promise.all([ import("@tsparticles/slim"), + import("@tsparticles/interaction-external-drag"), import("@tsparticles/interaction-external-trail"), import("@tsparticles/plugin-absorbers"), @@ -51,6 +53,7 @@ export async function loadFull(engine: Engine): Promise { await loadSlim(e); await Promise.all([ + loadExternalDragInteraction(e), loadExternalTrailInteraction(e), loadAbsorbersPlugin(e), diff --git a/bundles/pjs/CHANGELOG.md b/bundles/pjs/CHANGELOG.md index ce83e78f965..03efd66aa09 100644 --- a/bundles/pjs/CHANGELOG.md +++ b/bundles/pjs/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/pjs + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/pjs diff --git a/bundles/pjs/package.dist.json b/bundles/pjs/package.dist.json index de5a3207317..c55597b8987 100644 --- a/bundles/pjs/package.dist.json +++ b/bundles/pjs/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/pjs", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,9 +99,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-responsive": "4.0.0-alpha.28", - "tsparticles": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-responsive": "4.0.0-beta.0", + "tsparticles": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/pjs/package.json b/bundles/pjs/package.json index e97319e9adc..3e9edbe990f 100644 --- a/bundles/pjs/package.json +++ b/bundles/pjs/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/pjs", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,12 +107,12 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-responsive": "workspace:4.0.0-alpha.28", - "tsparticles": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-responsive": "workspace:4.0.0-beta.0", + "tsparticles": "workspace:4.0.0-beta.0" }, "devDependencies": { - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/bundles/slim/CHANGELOG.md b/bundles/slim/CHANGELOG.md index f3b252e24e1..2d774771762 100644 --- a/bundles/slim/CHANGELOG.md +++ b/bundles/slim/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/slim + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/slim diff --git a/bundles/slim/package.dist.json b/bundles/slim/package.dist.json index 8b9b4e2375a..e79350186f7 100644 --- a/bundles/slim/package.dist.json +++ b/bundles/slim/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/slim", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "repository": { @@ -99,33 +99,33 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/basic": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/interaction-external-attract": "4.0.0-alpha.28", - "@tsparticles/interaction-external-bounce": "4.0.0-alpha.28", - "@tsparticles/interaction-external-bubble": "4.0.0-alpha.28", - "@tsparticles/interaction-external-connect": "4.0.0-alpha.28", - "@tsparticles/interaction-external-grab": "4.0.0-alpha.28", - "@tsparticles/interaction-external-parallax": "4.0.0-alpha.28", - "@tsparticles/interaction-external-pause": "4.0.0-alpha.28", - "@tsparticles/interaction-external-push": "4.0.0-alpha.28", - "@tsparticles/interaction-external-remove": "4.0.0-alpha.28", - "@tsparticles/interaction-external-repulse": "4.0.0-alpha.28", - "@tsparticles/interaction-external-slow": "4.0.0-alpha.28", - "@tsparticles/interaction-particles-attract": "4.0.0-alpha.28", - "@tsparticles/interaction-particles-collisions": "4.0.0-alpha.28", - "@tsparticles/interaction-particles-links": "4.0.0-alpha.28", - "@tsparticles/plugin-easing-quad": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28", - "@tsparticles/shape-emoji": "4.0.0-alpha.28", - "@tsparticles/shape-image": "4.0.0-alpha.28", - "@tsparticles/shape-line": "4.0.0-alpha.28", - "@tsparticles/shape-polygon": "4.0.0-alpha.28", - "@tsparticles/shape-square": "4.0.0-alpha.28", - "@tsparticles/shape-star": "4.0.0-alpha.28", - "@tsparticles/updater-life": "4.0.0-alpha.28", - "@tsparticles/updater-rotate": "4.0.0-alpha.28", - "@tsparticles/updater-stroke-color": "4.0.0-alpha.28" + "@tsparticles/basic": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/interaction-external-attract": "4.0.0-beta.0", + "@tsparticles/interaction-external-bounce": "4.0.0-beta.0", + "@tsparticles/interaction-external-bubble": "4.0.0-beta.0", + "@tsparticles/interaction-external-connect": "4.0.0-beta.0", + "@tsparticles/interaction-external-grab": "4.0.0-beta.0", + "@tsparticles/interaction-external-parallax": "4.0.0-beta.0", + "@tsparticles/interaction-external-pause": "4.0.0-beta.0", + "@tsparticles/interaction-external-push": "4.0.0-beta.0", + "@tsparticles/interaction-external-remove": "4.0.0-beta.0", + "@tsparticles/interaction-external-repulse": "4.0.0-beta.0", + "@tsparticles/interaction-external-slow": "4.0.0-beta.0", + "@tsparticles/interaction-particles-attract": "4.0.0-beta.0", + "@tsparticles/interaction-particles-collisions": "4.0.0-beta.0", + "@tsparticles/interaction-particles-links": "4.0.0-beta.0", + "@tsparticles/plugin-easing-quad": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0", + "@tsparticles/shape-emoji": "4.0.0-beta.0", + "@tsparticles/shape-image": "4.0.0-beta.0", + "@tsparticles/shape-line": "4.0.0-beta.0", + "@tsparticles/shape-polygon": "4.0.0-beta.0", + "@tsparticles/shape-square": "4.0.0-beta.0", + "@tsparticles/shape-star": "4.0.0-beta.0", + "@tsparticles/updater-life": "4.0.0-beta.0", + "@tsparticles/updater-rotate": "4.0.0-beta.0", + "@tsparticles/updater-stroke-color": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/bundles/slim/package.json b/bundles/slim/package.json index 70023ee3f2a..f3c6ecd9eb3 100644 --- a/bundles/slim/package.json +++ b/bundles/slim/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/slim", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { @@ -107,33 +107,33 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/basic": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-attract": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-bounce": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-bubble": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-connect": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-grab": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-parallax": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-pause": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-push": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-remove": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-repulse": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-slow": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-attract": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-collisions": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-links": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quad": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-emoji": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-image": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-line": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-star": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-life": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-rotate": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-stroke-color": "workspace:4.0.0-alpha.28" + "@tsparticles/basic": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-attract": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-bounce": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-bubble": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-connect": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-grab": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-parallax": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-pause": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-push": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-remove": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-repulse": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-slow": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-attract": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-collisions": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-links": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quad": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0", + "@tsparticles/shape-emoji": "workspace:4.0.0-beta.0", + "@tsparticles/shape-image": "workspace:4.0.0-beta.0", + "@tsparticles/shape-line": "workspace:4.0.0-beta.0", + "@tsparticles/shape-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/shape-star": "workspace:4.0.0-beta.0", + "@tsparticles/updater-life": "workspace:4.0.0-beta.0", + "@tsparticles/updater-rotate": "workspace:4.0.0-beta.0", + "@tsparticles/updater-stroke-color": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/demo/electron/CHANGELOG.md b/demo/electron/CHANGELOG.md index add4877a4cf..6e3a29ade46 100644 --- a/demo/electron/CHANGELOG.md +++ b/demo/electron/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/electron-demo + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/electron-demo diff --git a/demo/electron/package.json b/demo/electron/package.json index 36dbf013728..937a9e9b17c 100644 --- a/demo/electron/package.json +++ b/demo/electron/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/electron-demo", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "", "main": "app/index.js", "private": true, @@ -14,12 +14,12 @@ "author": "Matteo Bruni ", "license": "MIT", "dependencies": { - "@tsparticles/configs": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "tsparticles": "workspace:4.0.0-alpha.28" + "@tsparticles/configs": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "tsparticles": "workspace:4.0.0-beta.0" }, "devDependencies": { - "electron": "^41.0.2" + "electron": "^41.0.3" }, "type": "module" } diff --git a/demo/vanilla/CHANGELOG.md b/demo/vanilla/CHANGELOG.md index 430c4fba781..2a8de17013d 100644 --- a/demo/vanilla/CHANGELOG.md +++ b/demo/vanilla/CHANGELOG.md @@ -3,6 +3,12 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Features + +- added drag & drop interaction external (mouse click) ([87ac189](https://github.com/tsparticles/tsparticles/commit/87ac189240ded4d3055d145fa7453bc9c17b1d82)) + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/demo diff --git a/demo/vanilla/app.ts b/demo/vanilla/app.ts index 0724f6ec0f2..1e5fb37a179 100644 --- a/demo/vanilla/app.ts +++ b/demo/vanilla/app.ts @@ -78,6 +78,7 @@ app.use("/interaction-external-attract", express.static("./node_modules/@tsparti app.use("/interaction-external-bounce", express.static("./node_modules/@tsparticles/interaction-external-bounce")); app.use("/interaction-external-bubble", express.static("./node_modules/@tsparticles/interaction-external-bubble")); app.use("/interaction-external-connect", express.static("./node_modules/@tsparticles/interaction-external-connect")); +app.use("/interaction-external-drag", express.static("./node_modules/@tsparticles/interaction-external-drag")); app.use("/interaction-external-grab", express.static("./node_modules/@tsparticles/interaction-external-grab")); app.use("/interaction-external-pause", express.static("./node_modules/@tsparticles/interaction-external-pause")); app.use("/interaction-external-push", express.static("./node_modules/@tsparticles/interaction-external-push")); diff --git a/demo/vanilla/package.json b/demo/vanilla/package.json index 3d693f17b16..2ade1747756 100644 --- a/demo/vanilla/package.json +++ b/demo/vanilla/package.json @@ -1,7 +1,7 @@ { "name": "@tsparticles/demo", "private": true, - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "> TODO: description", "author": "Matteo Bruni ", "homepage": "https://particles.js.org", @@ -29,7 +29,7 @@ "@types/connect-livereload": "^0.6.3", "@types/express": "^5.0.6", "@types/livereload": "^0.9.5", - "@types/node": "^25.4.0", + "@types/node": "^25.5.0", "@types/stylus": "^0.48.43", "ace-builds": "^1.43.6", "bootstrap": "^5.3.8", @@ -44,147 +44,148 @@ "livereload": "^0.10.3", "lodash": "^4.17.23", "nodemon": "^3.1.14", - "pug": "^3.0.3", + "pug": "^3.0.4", "stats.ts": "^2.1.6", "stylus": "^0.64.0", "winston": "^3.19.0" }, "dependencies": { - "@tsparticles/all": "workspace:4.0.0-alpha.28", - "@tsparticles/basic": "workspace:4.0.0-alpha.28", - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/confetti": "workspace:4.0.0-alpha.28", - "@tsparticles/configs": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-bubble": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-particles": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-shadow": "workspace:4.0.0-alpha.28", - "@tsparticles/effect-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/fireworks": "workspace:4.0.0-alpha.28", - "@tsparticles/fractal-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-attract": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-bounce": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-bubble": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-connect": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-grab": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-parallax": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-particle": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-pause": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-pop": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-push": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-remove": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-repulse": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-slow": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-external-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-light": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-attract": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-collisions": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-links": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-alpha.28", - "@tsparticles/noise-field": "workspace:4.0.0-alpha.28", - "@tsparticles/path-branches": "workspace:4.0.0-alpha.28", - "@tsparticles/path-brownian": "workspace:4.0.0-alpha.28", - "@tsparticles/path-curl-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-curves": "workspace:4.0.0-alpha.28", - "@tsparticles/path-fractal-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-grid": "workspace:4.0.0-alpha.28", - "@tsparticles/path-levy": "workspace:4.0.0-alpha.28", - "@tsparticles/path-perlin-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/path-random": "workspace:4.0.0-alpha.28", - "@tsparticles/path-simplex-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-spiral": "workspace:4.0.0-alpha.28", - "@tsparticles/path-svg": "workspace:4.0.0-alpha.28", - "@tsparticles/path-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/path-zig-zag": "workspace:4.0.0-alpha.28", - "@tsparticles/perlin-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/pjs": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-absorbers": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-background-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-blend": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-canvas-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-back": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-bounce": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-circ": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-cubic": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-elastic": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-expo": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-gaussian": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-linear": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quad": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quart": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-quint": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-sigmoid": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-sine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-easing-smoothstep": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-canvas": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-circle": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-path": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-image": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-json": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-export-video": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hex-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsl-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsv-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hwb-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-infection": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-lab-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-lch-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-manual-particles": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-motion": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-named-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-oklab-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-oklch-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-poisson-disc": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-polygon-mask": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-responsive": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-rgb-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-sounds": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-themes": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-trail": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-zoom": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-arrow": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-cards": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-circle": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-cog": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-emoji": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-heart": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-image": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-infinity": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-line": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-matrix": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-path": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-rounded-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-rounded-rect": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-spiral": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-square": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-squircle": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-star": "workspace:4.0.0-alpha.28", - "@tsparticles/shape-text": "workspace:4.0.0-alpha.28", - "@tsparticles/simplex-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/slim": "workspace:4.0.0-alpha.28", - "@tsparticles/smooth-value-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-destroy": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-fill-color": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-gradient": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-life": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-opacity": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-orbit": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-out-modes": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-roll": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-rotate": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-size": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-stroke-color": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-tilt": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-twinkle": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-wobble": "workspace:4.0.0-alpha.28", - "tsparticles": "workspace:4.0.0-alpha.28" + "@tsparticles/all": "workspace:4.0.0-beta.0", + "@tsparticles/basic": "workspace:4.0.0-beta.0", + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/confetti": "workspace:4.0.0-beta.0", + "@tsparticles/configs": "workspace:4.0.0-beta.0", + "@tsparticles/effect-bubble": "workspace:4.0.0-beta.0", + "@tsparticles/effect-particles": "workspace:4.0.0-beta.0", + "@tsparticles/effect-shadow": "workspace:4.0.0-beta.0", + "@tsparticles/effect-trail": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/fireworks": "workspace:4.0.0-beta.0", + "@tsparticles/fractal-noise": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-attract": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-bounce": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-bubble": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-connect": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-drag": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-grab": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-parallax": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-particle": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-pause": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-pop": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-push": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-remove": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-repulse": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-slow": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-external-trail": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-light": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-attract": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-collisions": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-links": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-beta.0", + "@tsparticles/noise-field": "workspace:4.0.0-beta.0", + "@tsparticles/path-branches": "workspace:4.0.0-beta.0", + "@tsparticles/path-brownian": "workspace:4.0.0-beta.0", + "@tsparticles/path-curl-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-curves": "workspace:4.0.0-beta.0", + "@tsparticles/path-fractal-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-grid": "workspace:4.0.0-beta.0", + "@tsparticles/path-levy": "workspace:4.0.0-beta.0", + "@tsparticles/path-perlin-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/path-random": "workspace:4.0.0-beta.0", + "@tsparticles/path-simplex-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-spiral": "workspace:4.0.0-beta.0", + "@tsparticles/path-svg": "workspace:4.0.0-beta.0", + "@tsparticles/path-utils": "workspace:4.0.0-beta.0", + "@tsparticles/path-zig-zag": "workspace:4.0.0-beta.0", + "@tsparticles/perlin-noise": "workspace:4.0.0-beta.0", + "@tsparticles/pjs": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-absorbers": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-background-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-blend": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-canvas-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-back": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-bounce": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-circ": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-cubic": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-elastic": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-expo": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-gaussian": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-linear": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quad": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quart": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-quint": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-sigmoid": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-sine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-easing-smoothstep": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-canvas": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-circle": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-path": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters-shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-image": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-json": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-export-video": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hex-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsl-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsv-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hwb-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-infection": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-lab-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-lch-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-manual-particles": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-motion": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-named-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-oklab-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-oklch-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-poisson-disc": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-polygon-mask": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-responsive": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-rgb-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-sounds": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-themes": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-trail": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-zoom": "workspace:4.0.0-beta.0", + "@tsparticles/shape-arrow": "workspace:4.0.0-beta.0", + "@tsparticles/shape-cards": "workspace:4.0.0-beta.0", + "@tsparticles/shape-circle": "workspace:4.0.0-beta.0", + "@tsparticles/shape-cog": "workspace:4.0.0-beta.0", + "@tsparticles/shape-emoji": "workspace:4.0.0-beta.0", + "@tsparticles/shape-heart": "workspace:4.0.0-beta.0", + "@tsparticles/shape-image": "workspace:4.0.0-beta.0", + "@tsparticles/shape-infinity": "workspace:4.0.0-beta.0", + "@tsparticles/shape-line": "workspace:4.0.0-beta.0", + "@tsparticles/shape-matrix": "workspace:4.0.0-beta.0", + "@tsparticles/shape-path": "workspace:4.0.0-beta.0", + "@tsparticles/shape-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/shape-rounded-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/shape-rounded-rect": "workspace:4.0.0-beta.0", + "@tsparticles/shape-spiral": "workspace:4.0.0-beta.0", + "@tsparticles/shape-square": "workspace:4.0.0-beta.0", + "@tsparticles/shape-squircle": "workspace:4.0.0-beta.0", + "@tsparticles/shape-star": "workspace:4.0.0-beta.0", + "@tsparticles/shape-text": "workspace:4.0.0-beta.0", + "@tsparticles/simplex-noise": "workspace:4.0.0-beta.0", + "@tsparticles/slim": "workspace:4.0.0-beta.0", + "@tsparticles/smooth-value-noise": "workspace:4.0.0-beta.0", + "@tsparticles/updater-destroy": "workspace:4.0.0-beta.0", + "@tsparticles/updater-fill-color": "workspace:4.0.0-beta.0", + "@tsparticles/updater-gradient": "workspace:4.0.0-beta.0", + "@tsparticles/updater-life": "workspace:4.0.0-beta.0", + "@tsparticles/updater-opacity": "workspace:4.0.0-beta.0", + "@tsparticles/updater-orbit": "workspace:4.0.0-beta.0", + "@tsparticles/updater-out-modes": "workspace:4.0.0-beta.0", + "@tsparticles/updater-roll": "workspace:4.0.0-beta.0", + "@tsparticles/updater-rotate": "workspace:4.0.0-beta.0", + "@tsparticles/updater-size": "workspace:4.0.0-beta.0", + "@tsparticles/updater-stroke-color": "workspace:4.0.0-beta.0", + "@tsparticles/updater-tilt": "workspace:4.0.0-beta.0", + "@tsparticles/updater-twinkle": "workspace:4.0.0-beta.0", + "@tsparticles/updater-wobble": "workspace:4.0.0-beta.0", + "tsparticles": "workspace:4.0.0-beta.0" }, "type": "module" } diff --git a/demo/vanilla/views/index.pug b/demo/vanilla/views/index.pug index 113de760318..635288cef70 100644 --- a/demo/vanilla/views/index.pug +++ b/demo/vanilla/views/index.pug @@ -129,6 +129,7 @@ html(lang="en") script(src="/interaction-external-bounce/tsparticles.interaction.external.bounce.min.js") script(src="/interaction-external-bubble/tsparticles.interaction.external.bubble.min.js") script(src="/interaction-external-connect/tsparticles.interaction.external.connect.min.js") + script(src="/interaction-external-drag/tsparticles.interaction.external.drag.min.js") script(src="/interaction-external-grab/tsparticles.interaction.external.grab.min.js") script(src="/interaction-external-parallax/tsparticles.interaction.external.parallax.min.js") script(src="/interaction-external-pause/tsparticles.interaction.external.pause.min.js") diff --git a/demo/vanilla/views/playground.pug b/demo/vanilla/views/playground.pug index 28db5087dff..8065393d239 100644 --- a/demo/vanilla/views/playground.pug +++ b/demo/vanilla/views/playground.pug @@ -115,6 +115,7 @@ html(lang="en") script(src="/interaction-external-bounce/tsparticles.interaction.external.bounce.js") script(src="/interaction-external-bubble/tsparticles.interaction.external.bubble.js") script(src="/interaction-external-connect/tsparticles.interaction.external.connect.js") + script(src="/interaction-external-drag/tsparticles.interaction.external.drag.js") script(src="/interaction-external-grab/tsparticles.interaction.external.grab.js") script(src="/interaction-external-pause/tsparticles.interaction.external.pause.js") script(src="/interaction-external-push/tsparticles.interaction.external.push.js") diff --git a/demo/vanilla/views/slim.pug b/demo/vanilla/views/slim.pug index fa7ee6eef95..fa2335d6de7 100644 --- a/demo/vanilla/views/slim.pug +++ b/demo/vanilla/views/slim.pug @@ -176,6 +176,7 @@ html(lang="en") script(src="/interaction-external-bounce/tsparticles.interaction.external.bounce.min.js") script(src="/interaction-external-bubble/tsparticles.interaction.external.bubble.min.js") script(src="/interaction-external-connect/tsparticles.interaction.external.connect.min.js") + script(src="/interaction-external-drag/tsparticles.interaction.external.drag.min.js") script(src="/interaction-external-grab/tsparticles.interaction.external.grab.min.js") script(src="/interaction-external-parallax/tsparticles.interaction.external.parallax.min.js") script(src="/interaction-external-pause/tsparticles.interaction.external.pause.min.js") diff --git a/demo/vanilla_new/CHANGELOG.md b/demo/vanilla_new/CHANGELOG.md index 27be11e011b..fb72392b2d4 100644 --- a/demo/vanilla_new/CHANGELOG.md +++ b/demo/vanilla_new/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/demo-new + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/demo-new diff --git a/demo/vanilla_new/package.json b/demo/vanilla_new/package.json index 03e5be6425d..b43cc393f38 100644 --- a/demo/vanilla_new/package.json +++ b/demo/vanilla_new/package.json @@ -1,7 +1,7 @@ { "name": "@tsparticles/demo-new", "private": true, - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles Demo Website", "main": "index.html", "scripts": { @@ -40,18 +40,18 @@ "sass": "^1.98.0" }, "dependencies": { - "@tsparticles/configs": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-light": "workspace:4.0.0-alpha.28", - "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-alpha.28", - "@tsparticles/path-curves": "workspace:4.0.0-alpha.28", - "@tsparticles/path-perlin-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/path-polygon": "workspace:4.0.0-alpha.28", - "@tsparticles/path-simplex-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-infection": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-gradient": "workspace:4.0.0-alpha.28", - "@tsparticles/updater-orbit": "workspace:4.0.0-alpha.28", - "tsparticles": "workspace:4.0.0-alpha.28" + "@tsparticles/configs": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-light": "workspace:4.0.0-beta.0", + "@tsparticles/interaction-particles-repulse": "workspace:4.0.0-beta.0", + "@tsparticles/path-curves": "workspace:4.0.0-beta.0", + "@tsparticles/path-perlin-noise": "workspace:4.0.0-beta.0", + "@tsparticles/path-polygon": "workspace:4.0.0-beta.0", + "@tsparticles/path-simplex-noise": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-infection": "workspace:4.0.0-beta.0", + "@tsparticles/updater-gradient": "workspace:4.0.0-beta.0", + "@tsparticles/updater-orbit": "workspace:4.0.0-beta.0", + "tsparticles": "workspace:4.0.0-beta.0" }, "type": "module" } diff --git a/demo/vite/CHANGELOG.md b/demo/vite/CHANGELOG.md index 188bc0b64b5..608e9712c01 100644 --- a/demo/vite/CHANGELOG.md +++ b/demo/vite/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/vite-demo + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/vite-demo diff --git a/demo/vite/package.json b/demo/vite/package.json index 4f52348ba2d..a3447c4c3df 100644 --- a/demo/vite/package.json +++ b/demo/vite/package.json @@ -1,7 +1,7 @@ { "name": "@tsparticles/vite-demo", "private": true, - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "type": "module", "scripts": { "dev": "vite", @@ -9,12 +9,12 @@ "preview": "vite preview" }, "dependencies": { - "@tsparticles/all": "workspace:4.0.0-alpha.28", - "@tsparticles/configs": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/all": "workspace:4.0.0-beta.0", + "@tsparticles/configs": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "devDependencies": { "typescript": "^5.9.3", - "vite": "^8.0.0" + "vite": "^7.3.1" } } diff --git a/effects/bubble/CHANGELOG.md b/effects/bubble/CHANGELOG.md index 347a7358db4..94fe37a59ca 100644 --- a/effects/bubble/CHANGELOG.md +++ b/effects/bubble/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/effect-bubble + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/effect-bubble diff --git a/effects/bubble/package.dist.json b/effects/bubble/package.dist.json index ccd646666c9..fec9ddbbeda 100644 --- a/effects/bubble/package.dist.json +++ b/effects/bubble/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-bubble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bubble effect", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/effects/bubble/package.json b/effects/bubble/package.json index 0d7abfe0727..e3356d982f1 100644 --- a/effects/bubble/package.json +++ b/effects/bubble/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-bubble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bubble effect", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/effects/particles/CHANGELOG.md b/effects/particles/CHANGELOG.md index 106f11ea07e..e43bbb694d6 100644 --- a/effects/particles/CHANGELOG.md +++ b/effects/particles/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/effect-particles + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/effect-particles diff --git a/effects/particles/package.dist.json b/effects/particles/package.dist.json index c10027a8de9..ab9123f055e 100644 --- a/effects/particles/package.dist.json +++ b/effects/particles/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-particles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles effect", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/effects/particles/package.json b/effects/particles/package.json index f5fba9e8ba8..f4f18186f85 100644 --- a/effects/particles/package.json +++ b/effects/particles/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-particles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles effect", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/effects/shadow/CHANGELOG.md b/effects/shadow/CHANGELOG.md index f2f127635b1..eaa45845a6f 100644 --- a/effects/shadow/CHANGELOG.md +++ b/effects/shadow/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/effect-shadow + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/effect-shadow diff --git a/effects/shadow/package.dist.json b/effects/shadow/package.dist.json index f4130396f0c..2d326fcd679 100644 --- a/effects/shadow/package.dist.json +++ b/effects/shadow/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-shadow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles shadow effect", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/effects/shadow/package.json b/effects/shadow/package.json index 348ff4eb7af..2da62494812 100644 --- a/effects/shadow/package.json +++ b/effects/shadow/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-shadow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles shadow effect", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/effects/trail/CHANGELOG.md b/effects/trail/CHANGELOG.md index c48de09fab0..f39ef93e4ff 100644 --- a/effects/trail/CHANGELOG.md +++ b/effects/trail/CHANGELOG.md @@ -3,6 +3,16 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Bug Fixes + +- improved trail drawer outcome a bit ([4f5368f](https://github.com/tsparticles/tsparticles/commit/4f5368ff0b404a6c3a440b23020b2ba78eb8e17b)) +- improved trail drawer outcome a bit ([90154ac](https://github.com/tsparticles/tsparticles/commit/90154acc3322bdc4c1f5d40eda1bea3688c2d60a)) +- improved trail drawer performance a bit ([8a28709](https://github.com/tsparticles/tsparticles/commit/8a28709e00f524fcd65bd54d6194e60b9c60845d)) +- reduced checks on trail drawing ([2cc5614](https://github.com/tsparticles/tsparticles/commit/2cc5614c96f0d8f8fa4b4a7c3f882df2778e4cf5)) +- reduced checks on trail drawing ([c1201d2](https://github.com/tsparticles/tsparticles/commit/c1201d24560ed60b49b560ab1ac6950c0b074e58)) + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/effect-trail diff --git a/effects/trail/package.dist.json b/effects/trail/package.dist.json index 61ca3fbbf77..e1450c75231 100644 --- a/effects/trail/package.dist.json +++ b/effects/trail/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail effect", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/effects/trail/package.json b/effects/trail/package.json index 4576d2e76c2..a1c25fdbd64 100644 --- a/effects/trail/package.json +++ b/effects/trail/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/effect-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail effect", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/effects/trail/src/TrailDrawer.ts b/effects/trail/src/TrailDrawer.ts index 9b91edc6564..71641f4f21d 100644 --- a/effects/trail/src/TrailDrawer.ts +++ b/effects/trail/src/TrailDrawer.ts @@ -11,14 +11,16 @@ import { getDistances, getRangeValue, half, - none, originPoint, } from "@tsparticles/engine"; -const minTrailLength = 2, +const minTrailLength = 3, trailLengthOffset = 1, minWidth = -1, - defaultLength = 10; + firstIndex = 0, + defaultLength = 10, + loopTrailLengthOffset = 2, + loopTrailLengthMinIndex = 0; interface TrailStep { color: string | CanvasGradient | CanvasPattern; @@ -82,38 +84,49 @@ export class TrailDrawer implements IEffectDrawer { return; } - while (trail.length > pathLength) { - trail.shift(); + const pathLengthFloor = Math.floor(pathLength); + + if (trail.length > pathLengthFloor) { + trail.splice(firstIndex, trail.length - pathLengthFloor); } const trailLength = Math.min(trail.length, pathLength), canvasSize = { width: particle.container.canvas.size.width * drawScale + diameter, height: particle.container.canvas.size.height * drawScale + diameter, - }, - trailPos = trail[trailLength - trailLengthOffset]; + }; - if (!trailPos) { - return; - } + context.save(); - let lastPos = trailPos.position; + context.lineCap = "butt"; + context.lineJoin = "round"; - for (let i = trailLength; i > none; i--) { - const step = trail[i - trailLengthOffset]; + for (let i = trailLength - loopTrailLengthOffset; i > loopTrailLengthMinIndex; i--) { + const previousStep = trail[i + trailLengthOffset], + step = trail[i], + nextStep = trail[i - trailLengthOffset]; - if (!step) { + if (!previousStep || !step || !nextStep) { continue; } - const position = step.position, + const previousPosition = previousStep.position, + position = step.position, + nextPosition = nextStep.position, stepTransformData = particle.trailTransform ? (step.transformData ?? defaultTransform) : defaultTransform, - { distance, dx, dy } = getDistances(lastPos, position); + { distance: previousDistance } = getDistances(previousPosition, position), + { distance: nextDistance } = getDistances(position, nextPosition); - // Skip segment if distance is too large (wrap or zoom change) - if (distance > pathLength * double) { - lastPos = position; + if (previousDistance > pathLength * double || nextDistance > pathLength * double) { + continue; + } + if ( + Math.abs(previousPosition.x - position.x) > canvasSize.width * half || + Math.abs(previousPosition.y - position.y) > canvasSize.height * half || + Math.abs(position.x - nextPosition.x) > canvasSize.width * half || + Math.abs(position.y - nextPosition.y) > canvasSize.height * half + ) { continue; } @@ -126,24 +139,14 @@ export class TrailDrawer implements IEffectDrawer { position.y, ); - context.beginPath(); - context.moveTo(dx, dy); - - const warp = { - x: (lastPos.x + canvasSize.width) % canvasSize.width, - y: (lastPos.y + canvasSize.height) % canvasSize.height, - }; - - if (Math.abs(dx) > canvasSize.width * half || Math.abs(dy) > canvasSize.height * half) { - lastPos = position; - - continue; - } + const startX = (previousPosition.x + position.x) * half - position.x, + startY = (previousPosition.y + position.y) * half - position.y, + endX = (position.x + nextPosition.x) * half - position.x, + endY = (position.y + nextPosition.y) * half - position.y; - context.lineTo( - Math.abs(dx) > canvasSize.width * half ? warp.x : originPoint.x, - Math.abs(dy) > canvasSize.height * half ? warp.y : originPoint.y, - ); + context.beginPath(); + context.moveTo(startX, startY); + context.quadraticCurveTo(originPoint.x, originPoint.y, endX, endY); const width = Math.max((i / trailLength) * diameter, pxRatio, (particle.trailMinWidth ?? minWidth) * drawScale), oldAlpha = context.globalAlpha; @@ -155,9 +158,9 @@ export class TrailDrawer implements IEffectDrawer { context.stroke(); context.globalAlpha = oldAlpha; - - lastPos = position; } + + context.restore(); } particleInit(container: Container, particle: TrailParticle): void { diff --git a/engine/CHANGELOG.md b/engine/CHANGELOG.md index a33c132e6b5..627a9a4a10a 100644 --- a/engine/CHANGELOG.md +++ b/engine/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/engine + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/engine diff --git a/engine/package.dist.json b/engine/package.dist.json index 4377814228f..0b18fe275ef 100644 --- a/engine/package.dist.json +++ b/engine/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/engine", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { diff --git a/engine/package.json b/engine/package.json index cce810be3cc..9b0ea00b043 100644 --- a/engine/package.json +++ b/engine/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/engine", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.", "homepage": "https://particles.js.org", "scripts": { diff --git a/engine/src/Core/Utils/Constants.ts b/engine/src/Core/Utils/Constants.ts index b3bb47e18e5..a43d276f1b5 100644 --- a/engine/src/Core/Utils/Constants.ts +++ b/engine/src/Core/Utils/Constants.ts @@ -32,12 +32,10 @@ export const generatedAttribute = "generated", canvasTag = "canvas", defaultRetryCount = 0, squareExp = 2, - qTreeCapacity = 4, spatialHashGridCellSize = 100, defaultRemoveQuantity = 1, defaultRatio = 1, defaultReduceFactor = 1, - subdivideCount = 4, inverseFactorNumerator = 1, rgbMax = 255, hMax = 360, @@ -52,12 +50,8 @@ export const generatedAttribute = "generated", minVelocity = 0, defaultTransformValue = 1, minimumSize = 0, - minimumLength = 0, zIndexFactorOffset = 1, defaultOpacity = 1, - clickRadius = 1, - touchEndLengthOffset = 1, - minCoordinate = 0, removeDeleteCount = 1, removeMinIndex = 0, defaultFpsLimit = 120, @@ -69,11 +63,7 @@ export const generatedAttribute = "generated", none = 0, decayOffset = 1, tryCountIncrement = 1, - minRetries = 0, minZ = 0, - defaultRadius = 0, - posOffset = -quarter, - sizeFactor = 1.5, minLimit = 0, countOffset = 1, minCount = 0, @@ -81,8 +71,6 @@ export const generatedAttribute = "generated", lengthOffset = 1, defaultDensityFactor = 1, deleteCount = 1, - touchDelay = 500, - manualDefaultPosition = 50, defaultAngle = 0, identity = 1, minStrokeWidth = 0, diff --git a/engine/src/Core/Utils/Ranges.ts b/engine/src/Core/Utils/Ranges.ts index f6fc39a95f4..3975f859b2d 100644 --- a/engine/src/Core/Utils/Ranges.ts +++ b/engine/src/Core/Utils/Ranges.ts @@ -29,6 +29,11 @@ export abstract class BaseRange { this.type = type; } + protected _resetPosition(x: number, y: number): void { + this.position.x = x; + this.position.y = y; + } + /** * Check if the point is inside the range * @param point - the point to check in the range @@ -47,18 +52,18 @@ export abstract class BaseRange { /** */ export class Circle extends BaseRange { + radius; + /** * Circle constructor, initialized position and radius * @param x - X coordinate of the position * @param y - Y coordinate of the position * @param radius - Circle's radius */ - constructor( - x: number, - y: number, - readonly radius: number, - ) { + constructor(x: number, y: number, radius: number) { super(x, y, RangeType.circle); + + this.radius = radius; } /** @@ -78,30 +83,34 @@ export class Circle extends BaseRange { intersects(range: BaseRange): boolean { const pos1 = this.position, pos2 = range.position, - distPos = { x: Math.abs(pos2.x - pos1.x), y: Math.abs(pos2.y - pos1.y) }, - r = this.radius; + r = this.radius, + dx = Math.abs(pos2.x - pos1.x), + dy = Math.abs(pos2.y - pos1.y); if (range instanceof Circle || range.type === (RangeType.circle as string)) { const circleRange = range as Circle, rSum = r + circleRange.radius, - dist = Math.hypot(distPos.x, distPos.y); + dist = Math.hypot(dx, dy); return rSum > dist; } else if (range instanceof Rectangle || range.type === (RangeType.rectangle as string)) { const rectRange = range as Rectangle, { width, height } = rectRange.size, - edges = Math.pow(distPos.x - width, squareExp) + Math.pow(distPos.y - height, squareExp); - - return ( - edges <= r ** squareExp || - (distPos.x <= r + width && distPos.y <= r + height) || - distPos.x <= width || - distPos.y <= height - ); + edges = Math.pow(dx - width, squareExp) + Math.pow(dy - height, squareExp); + + return edges <= r ** squareExp || (dx <= r + width && dy <= r + height) || dx <= width || dy <= height; } return false; } + + reset(x: number, y: number, radius: number): this { + this._resetPosition(x, y); + + this.radius = radius; + + return this; + } } /** @@ -151,14 +160,25 @@ export class Rectangle extends BaseRange { return range.intersects(this); } + if (!(range instanceof Rectangle)) { + return false; + } + const w = this.size.width, h = this.size.height, pos1 = this.position, pos2 = range.position, - size2 = range instanceof Rectangle ? range.size : { width: 0, height: 0 }, + size2 = range.size, w2 = size2.width, h2 = size2.height; return pos2.x < pos1.x + w && pos2.x + w2 > pos1.x && pos2.y < pos1.y + h && pos2.y + h2 > pos1.y; } + + reset(x: number, y: number, width: number, height: number): this { + this._resetPosition(x, y); + this.size.width = width; + this.size.height = height; + return this; + } } diff --git a/engine/src/Core/Utils/SpatialHashGrid.ts b/engine/src/Core/Utils/SpatialHashGrid.ts index 98b22c7f24e..a73cb494e70 100644 --- a/engine/src/Core/Utils/SpatialHashGrid.ts +++ b/engine/src/Core/Utils/SpatialHashGrid.ts @@ -16,10 +16,17 @@ interface RangeBounds { export class SpatialHashGrid { private _cellSize: number; private readonly _cells = new Map(); + private readonly _circlePool: Circle[] = []; + private _circlePoolIdx; private _pendingCellSize?: number; + private readonly _rectanglePool: Rectangle[] = []; + private _rectanglePoolIdx; constructor(cellSize: number) { this._cellSize = cellSize; + + this._circlePoolIdx = 0; + this._rectanglePoolIdx = 0; } /** @@ -95,44 +102,46 @@ export class SpatialHashGrid { return out; } - /** - * Convenience for circles - * @param position - - * @param radius - - * @param check - - * @param out - - * @returns - - */ queryCircle( position: ICoordinates, radius: number, check?: (particle: Particle) => boolean, out: Particle[] = [], ): Particle[] { - return this.query(new Circle(position.x, position.y, radius), check, out); + const circle = this._acquireCircle(position.x, position.y, radius), + result = this.query(circle, check, out); + + this._releaseShapes(); + + return result; } - /** - * Convenience for rectangles - * @param position - - * @param size - - * @param check - - * @param out - - * @returns - - */ queryRectangle( position: ICoordinates, size: IDimension, check?: (particle: Particle) => boolean, out: Particle[] = [], ): Particle[] { - return this.query(new Rectangle(position.x, position.y, size.width, size.height), check, out); + const rect = this._acquireRectangle(position.x, position.y, size.width, size.height), + result = this.query(rect, check, out); + + this._releaseShapes(); + + return result; } setCellSize(cellSize: number): void { this._pendingCellSize = cellSize; } + private _acquireCircle(x: number, y: number, r: number): Circle { + return (this._circlePool[this._circlePoolIdx++] ??= new Circle(x, y, r)).reset(x, y, r); + } + + private _acquireRectangle(x: number, y: number, w: number, h: number): Rectangle { + return (this._rectanglePool[this._rectanglePoolIdx++] ??= new Rectangle(x, y, w, h)).reset(x, y, w, h); + } + /** * Convert coordinates to cell key * @param x - @@ -178,4 +187,9 @@ export class SpatialHashGrid { return null; } + + private _releaseShapes(): void { + this._circlePoolIdx = 0; + this._rectanglePoolIdx = 0; + } } diff --git a/interactions/external/attract/CHANGELOG.md b/interactions/external/attract/CHANGELOG.md index b153a7cb39f..1c93c58e384 100644 --- a/interactions/external/attract/CHANGELOG.md +++ b/interactions/external/attract/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-attract + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-attract diff --git a/interactions/external/attract/package.dist.json b/interactions/external/attract/package.dist.json index 28a5865f6f2..72ae7bc3c63 100644 --- a/interactions/external/attract/package.dist.json +++ b/interactions/external/attract/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-attract", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles attract external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/attract/package.json b/interactions/external/attract/package.json index 6930a8b0f2e..f7a8da04955 100644 --- a/interactions/external/attract/package.json +++ b/interactions/external/attract/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-attract", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles attract external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/bounce/CHANGELOG.md b/interactions/external/bounce/CHANGELOG.md index 89d9c84c5af..7c98ac9a327 100644 --- a/interactions/external/bounce/CHANGELOG.md +++ b/interactions/external/bounce/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-bounce + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-bounce diff --git a/interactions/external/bounce/package.dist.json b/interactions/external/bounce/package.dist.json index 43713cdb14e..ffa1d4492ba 100644 --- a/interactions/external/bounce/package.dist.json +++ b/interactions/external/bounce/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-bounce", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bounce external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/bounce/package.json b/interactions/external/bounce/package.json index 84cf20bf126..2e4f1b61321 100644 --- a/interactions/external/bounce/package.json +++ b/interactions/external/bounce/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-bounce", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bounce external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/bubble/CHANGELOG.md b/interactions/external/bubble/CHANGELOG.md index cdcc982907b..a84b8baf0e8 100644 --- a/interactions/external/bubble/CHANGELOG.md +++ b/interactions/external/bubble/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-bubble + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-bubble diff --git a/interactions/external/bubble/package.dist.json b/interactions/external/bubble/package.dist.json index c11d1e51eb1..296abd8ad09 100644 --- a/interactions/external/bubble/package.dist.json +++ b/interactions/external/bubble/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-bubble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bubble external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/bubble/package.json b/interactions/external/bubble/package.json index 5104345dca6..0618b73bbad 100644 --- a/interactions/external/bubble/package.json +++ b/interactions/external/bubble/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-bubble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles bubble external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/connect/CHANGELOG.md b/interactions/external/connect/CHANGELOG.md index 437224d2938..4f490154f9d 100644 --- a/interactions/external/connect/CHANGELOG.md +++ b/interactions/external/connect/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-connect + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-connect diff --git a/interactions/external/connect/package.dist.json b/interactions/external/connect/package.dist.json index 7421d5ab53b..710bef62eed 100644 --- a/interactions/external/connect/package.dist.json +++ b/interactions/external/connect/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-connect", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles connect external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,9 +87,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/connect/package.json b/interactions/external/connect/package.json index d2c7d47eb93..587ae1e7e1f 100644 --- a/interactions/external/connect/package.json +++ b/interactions/external/connect/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-connect", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles connect external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,9 +95,9 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/drag/.browserslistrc b/interactions/external/drag/.browserslistrc new file mode 100644 index 00000000000..8e3f6e2d618 --- /dev/null +++ b/interactions/external/drag/.browserslistrc @@ -0,0 +1,3 @@ +since 2021 +not dead + diff --git a/interactions/external/drag/.npmignore b/interactions/external/drag/.npmignore new file mode 100644 index 00000000000..ec3632c8123 --- /dev/null +++ b/interactions/external/drag/.npmignore @@ -0,0 +1,2 @@ +report.html + diff --git a/interactions/external/drag/CHANGELOG.md b/interactions/external/drag/CHANGELOG.md new file mode 100644 index 00000000000..d455f35ccf3 --- /dev/null +++ b/interactions/external/drag/CHANGELOG.md @@ -0,0 +1,11 @@ +# Change Log + +All notable changes to this project will be documented in this file. +See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. + +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Features + +- added drag & drop interaction external (mouse click) ([87ac189](https://github.com/tsparticles/tsparticles/commit/87ac189240ded4d3055d145fa7453bc9c17b1d82)) +- added momentum option to drag & drop interactor ([12d3696](https://github.com/tsparticles/tsparticles/commit/12d3696376d98c9000ff73cd518b1eae268a59b4)) diff --git a/interactions/external/drag/LICENSE b/interactions/external/drag/LICENSE new file mode 100644 index 00000000000..bdc05f528fa --- /dev/null +++ b/interactions/external/drag/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2020 Matteo Bruni + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/interactions/external/drag/README.md b/interactions/external/drag/README.md new file mode 100644 index 00000000000..9316e8d01aa --- /dev/null +++ b/interactions/external/drag/README.md @@ -0,0 +1,88 @@ +[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org) + +# tsParticles External Drag Interaction + +[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/interaction-external-drag/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/interaction-external-drag) +[![npmjs](https://badge.fury.io/js/@tsparticles/interaction-external-drag.svg)](https://www.npmjs.com/package/@tsparticles/interaction-external-drag) +[![npmjs](https://img.shields.io/npm/dt/@tsparticles/interaction-external-drag)](https://www.npmjs.com/package/@tsparticles/interaction-external-drag) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni) + +[tsParticles](https://github.com/tsparticles/tsparticles) interaction plugin for dragging particles across the canvas +with the mouse/pointer. + +## How to use it + +### CDN / Vanilla JS / jQuery + +The CDN/Vanilla version JS has one required file in vanilla configuration: + +Including the `tsparticles.interaction.external.drag.min.js` file will export the function to load the interaction +plugin: + +```javascript +loadExternalDragInteraction; +``` + +### Usage + +Once the scripts are loaded you can set up `tsParticles` and the interaction plugin like this: + +```javascript +(async () => { + await loadInteractivityPlugin(tsParticles); + await loadExternalDragInteraction(tsParticles); + + await tsParticles.load({ + id: "tsparticles", + options: { + interactivity: { + events: { + onClick: { + enable: true, + mode: "drag", + }, + }, + }, + }, + }); +})(); +``` + +### ESM / CommonJS + +This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this: + +```shell +$ npm install @tsparticles/interaction-external-drag +``` + +or + +```shell +$ yarn add @tsparticles/interaction-external-drag +``` + +Then you need to import it in the app, like this: + +```javascript +const { tsParticles } = require("@tsparticles/engine"); +const { loadInteractivityPlugin } = require("@tsparticles/plugin-interactivity"); +const { loadExternalDragInteraction } = require("@tsparticles/interaction-external-drag"); + +(async () => { + await loadInteractivityPlugin(tsParticles); + await loadExternalDragInteraction(tsParticles); +})(); +``` + +or + +```javascript +import { tsParticles } from "@tsparticles/engine"; +import { loadInteractivityPlugin } from "@tsparticles/plugin-interactivity"; +import { loadExternalDragInteraction } from "@tsparticles/interaction-external-drag"; + +(async () => { + await loadInteractivityPlugin(tsParticles); + await loadExternalDragInteraction(tsParticles); +})(); +``` diff --git a/interactions/external/drag/eslint.config.js b/interactions/external/drag/eslint.config.js new file mode 100644 index 00000000000..4304e66d2b2 --- /dev/null +++ b/interactions/external/drag/eslint.config.js @@ -0,0 +1,7 @@ +import tsParticlesESLintConfig from "@tsparticles/eslint-config"; +import { defineConfig } from "eslint/config"; + +export default defineConfig([ + tsParticlesESLintConfig, +]); + diff --git a/interactions/external/drag/package.dist.json b/interactions/external/drag/package.dist.json new file mode 100644 index 00000000000..39a3e935aa0 --- /dev/null +++ b/interactions/external/drag/package.dist.json @@ -0,0 +1,97 @@ +{ + "name": "@tsparticles/interaction-external-drag", + "version": "4.0.0-beta.0", + "description": "tsParticles drag external interaction", + "homepage": "https://particles.js.org", + "repository": { + "type": "git", + "url": "git+https://github.com/tsparticles/tsparticles.git", + "directory": "interactions/external/drag" + }, + "keywords": [ + "front-end", + "frontend", + "tsparticles", + "particles.js", + "particlesjs", + "particles", + "particle", + "canvas", + "jsparticles", + "xparticles", + "particles-js", + "particles-bg", + "particles-bg-vue", + "particles-ts", + "particles.ts", + "react-particles-js", + "react-particles.js", + "react-particles", + "react", + "reactjs", + "vue-particles", + "ngx-particles", + "angular-particles", + "particleground", + "vue", + "vuejs", + "preact", + "preactjs", + "jquery", + "angularjs", + "angular", + "typescript", + "javascript", + "animation", + "web", + "html5", + "web-design", + "webdesign", + "css", + "html", + "css3", + "animated", + "background", + "confetti", + "canvas", + "fireworks", + "fireworks-js", + "confetti-js", + "confettijs", + "fireworksjs", + "canvas-confetti", + "tsparticles-plugin", + "@tsparticles/interaction" + ], + "author": "Matteo Bruni ", + "license": "MIT", + "bugs": { + "url": "https://github.com/tsparticles/tsparticles/issues" + }, + "sideEffects": false, + "jsdelivr": "tsparticles.interaction.external.drag.min.js", + "unpkg": "tsparticles.interaction.external.drag.min.js", + "browser": "browser/index.js", + "main": "cjs/index.js", + "module": "esm/index.js", + "types": "types/index.d.ts", + "exports": { + ".": { + "types": "./types/index.d.ts", + "browser": "./browser/index.js", + "import": "./esm/index.js", + "require": "./cjs/index.js", + "umd": "./umd/index.js", + "default": "./cjs/index.js" + }, + "./package.json": "./package.json" + }, + "dependencies": { + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" + }, + "publishConfig": { + "access": "public" + }, + "type": "module" +} diff --git a/interactions/external/drag/package.json b/interactions/external/drag/package.json new file mode 100644 index 00000000000..5eb5ee4c26d --- /dev/null +++ b/interactions/external/drag/package.json @@ -0,0 +1,79 @@ +{ + "name": "@tsparticles/interaction-external-drag", + "version": "4.0.0-beta.0", + "description": "tsParticles drag external interaction", + "homepage": "https://particles.js.org", + "scripts": { + "build": "tsparticles-cli build", + "build:ci": "tsparticles-cli build --ci", + "version": "tsparticles-cli build -d && git add package.dist.json && tsparticles-cli build -p -l && git add .", + "prepack": "pnpm run build" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/tsparticles/tsparticles.git", + "directory": "interactions/external/drag" + }, + "keywords": [ + "front-end", + "frontend", + "tsparticles", + "particles", + "particle", + "canvas", + "jsparticles", + "xparticles", + "particles-js", + "particles.js", + "particles-ts", + "particles.ts", + "typescript", + "javascript", + "animation", + "web", + "html5", + "web-design", + "webdesign", + "css", + "html", + "css3", + "animated", + "background", + "@tsparticles/interaction" + ], + "author": "Matteo Bruni ", + "license": "MIT", + "bugs": { + "url": "https://github.com/tsparticles/tsparticles/issues" + }, + "prettier": "@tsparticles/prettier-config", + "files": [ + "dist" + ], + "sideEffects": false, + "browser": "dist/browser/index.js", + "main": "dist/cjs/index.js", + "module": "dist/esm/index.js", + "types": "dist/types/index.d.ts", + "exports": { + ".": { + "types": "./dist/types/index.d.ts", + "browser": "./dist/browser/index.js", + "import": "./dist/esm/index.js", + "require": "./dist/cjs/index.js", + "umd": "./dist/umd/index.js", + "default": "./dist/cjs/index.js" + }, + "./package.json": "./dist/package.json" + }, + "dependencies": { + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" + }, + "publishConfig": { + "access": "public", + "directory": "dist", + "linkDirectory": true + }, + "type": "module" +} diff --git a/interactions/external/drag/src/Dragger.ts b/interactions/external/drag/src/Dragger.ts new file mode 100644 index 00000000000..4b0396a7bdb --- /dev/null +++ b/interactions/external/drag/src/Dragger.ts @@ -0,0 +1,276 @@ +import type { DragContainer, DragMode, IDragMode } from "./Types.js"; +import { + ExternalInteractorBase, + type IInteractivityData, + type IModes, + type InteractivityParticle, + type Modes, +} from "@tsparticles/plugin-interactivity"; +import { + type IDelta, + type Particle, + type RecursivePartial, + defaultFps, + getDistance, + isInArray, + millisecondsToSeconds, +} from "@tsparticles/engine"; +import { Drag } from "./Options/Classes/Drag.js"; + +const clickReleaseDelayMs = 50, + defaultMomentumFactor = 0.03, + dragMode = "drag", + firstSampleIndex = 0, + lastSampleOffset = 1, + maxMomentumSamples = 5, + minSamplesForMomentum = 2, + momentumToVelocityFactor = millisecondsToSeconds / defaultFps, + zeroValue = 0; + +interface MomentumSample { + t: number; + x: number; + y: number; +} + +/** + * External drag-and-drop interactor. + * Allows the user to click and drag particles across the canvas. + * Relies on pointer state provided by the interactivity plugin. + * + * Options (under `interactivity.modes.drag`): + * - `preserveMomentum` — if `true`, the particle retains the velocity of the drag gesture on release. + * - `momentumFactor` — scaling factor for the computed drag velocity (default `0.03`). + */ +export class Dragger extends ExternalInteractorBase { + readonly maxDistance = 0; + + private _dragStartClickTime?: number; + private _dragStartClickingFalseTime?: number; + private _draggedParticle?: Particle; + private _grabOffset?: { x: number; y: number }; + private _lastMousePosition?: { x: number; y: number }; + private _momentumSamples: MomentumSample[] = []; + private _mouseDownHandled = false; + private _savedVelocity?: { x: number; y: number }; + + // eslint-disable-next-line @typescript-eslint/no-useless-constructor + constructor(container: DragContainer) { + super(container); + } + + clear(_particle: InteractivityParticle, _delta: IDelta): void { + // do nothing + } + + init(): void { + // do nothing + } + + interact(interactivityData: IInteractivityData, _delta: IDelta): void { + const mouse = interactivityData.mouse, + mousePos = mouse.position; + + // Keep the last known pointer position from interactivity plugin events + if (mousePos) { + this._lastMousePosition = mousePos; + } + + // Move the already-grabbed particle + if (this._draggedParticle) { + const now = performance.now(); + + if (!mouse.clicking) { + this._dragStartClickingFalseTime ??= now; + } else { + this._dragStartClickingFalseTime = undefined; + } + + // Fallback for environments where the first interaction can miss clickTime updates. + const hasStableClickEndWithoutClickTime = + this._dragStartClickTime === undefined && + this._dragStartClickingFalseTime !== undefined && + now - this._dragStartClickingFalseTime >= clickReleaseDelayMs; + + if (!mouse.inside || this._hasClickEnded(mouse) || hasStableClickEndWithoutClickTime) { + this._releaseDragged(); + this._mouseDownHandled = false; + + return; + } + + const pointerPos = mousePos ?? this._lastMousePosition; + + if (!pointerPos) { + return; + } + + // Track pointer positions for momentum calculation + + this._momentumSamples.push({ x: pointerPos.x, y: pointerPos.y, t: now }); + + if (this._momentumSamples.length > maxMomentumSamples) { + this._momentumSamples.shift(); + } + + const targetX = pointerPos.x + (this._grabOffset?.x ?? zeroValue), + targetY = pointerPos.y + (this._grabOffset?.y ?? zeroValue); + + this._draggedParticle.position.x = targetX - this._draggedParticle.offset.x; + this._draggedParticle.position.y = targetY - this._draggedParticle.offset.y; + this._draggedParticle.velocity.x = zeroValue; + this._draggedParticle.velocity.y = zeroValue; + this._draggedParticle.initialPosition.x = this._draggedParticle.position.x; + this._draggedParticle.initialPosition.y = this._draggedParticle.position.y; + this._draggedParticle.misplaced = false; + + return; + } + + if (!mouse.clicking) { + this._releaseDragged(); + this._mouseDownHandled = false; + + return; + } + + // Start drag only once per mousedown + if (this._mouseDownHandled) { + return; + } + + this._mouseDownHandled = true; + + const downPos = mouse.downPosition ?? mousePos ?? this._lastMousePosition, + closest = this._findParticleUnderCursor(interactivityData, downPos); + + if (!closest || !mousePos) { + if (!closest) { + this._mouseDownHandled = false; + } + + return; + } + + const renderedPos = closest.getPosition(); + + this._draggedParticle = closest; + this._dragStartClickTime = mouse.clickTime; + this._grabOffset = { + x: renderedPos.x - mousePos.x, + y: renderedPos.y - mousePos.y, + }; + this._savedVelocity = { x: closest.velocity.x, y: closest.velocity.y }; + this._dragStartClickingFalseTime = undefined; + this._momentumSamples = [{ x: mousePos.x, y: mousePos.y, t: performance.now() }]; + + closest.velocity.x = zeroValue; + closest.velocity.y = zeroValue; + closest.position.x = renderedPos.x - closest.offset.x; + closest.position.y = renderedPos.y - closest.offset.y; + closest.initialPosition.x = closest.position.x; + closest.initialPosition.y = closest.position.y; + closest.misplaced = false; + } + + isEnabled(interactivityData: IInteractivityData, particle?: InteractivityParticle): boolean { + const container = this.container, + mouse = interactivityData.mouse, + events = (particle?.interactivity ?? container.actualOptions.interactivity)?.events; + + if (this._draggedParticle || this._mouseDownHandled) { + return true; + } + + return !!events?.onClick.enable && mouse.clicking && !!mouse.position && isInArray(dragMode, events.onClick.mode); + } + + loadModeOptions(options: Modes & DragMode, ...sources: RecursivePartial<(IModes & IDragMode) | undefined>[]): void { + options.drag ??= new Drag(); + + for (const source of sources) { + options.drag.load(source?.drag); + } + } + + reset(_interactivityData: IInteractivityData, _particle: InteractivityParticle): void { + // do nothing - release logic is handled in interact() + } + + private _findParticleUnderCursor( + interactivityData: IInteractivityData, + mousePos?: { x: number; y: number }, + ): Particle | undefined { + if (!mousePos) { + return; + } + + const candidates = this.container.particles.filter(p => this.isEnabled(interactivityData, p)); + + let closest: Particle | undefined, + closestDist = Infinity; + + for (const candidate of candidates) { + const dist = getDistance(candidate.getPosition(), mousePos), + radius = candidate.getRadius(); + + if (!Number.isFinite(dist) || !Number.isFinite(radius) || dist > radius || dist >= closestDist) { + continue; + } + + closest = candidate; + closestDist = dist; + } + + return closest; + } + + private _hasClickEnded(mouse: IInteractivityData["mouse"]): boolean { + return ( + this._dragStartClickTime !== undefined && + mouse.clickTime !== undefined && + mouse.clickTime !== this._dragStartClickTime + ); + } + + private _releaseDragged(): void { + if (this._draggedParticle) { + const dragOptions = this.container.actualOptions.interactivity?.modes.drag, + preserveMomentum = dragOptions?.preserveMomentum ?? false; + + if (preserveMomentum && this._momentumSamples.length >= minSamplesForMomentum) { + const first = this._momentumSamples[firstSampleIndex], + last = this._momentumSamples[this._momentumSamples.length - lastSampleOffset]; + + if (first && last) { + const dt = last.t - first.t; + + if (dt > zeroValue) { + const factor = dragOptions?.momentumFactor ?? defaultMomentumFactor; + + // Convert pointer speed (px/ms) to engine velocity unit used by move updater. + this._draggedParticle.velocity.x = ((last.x - first.x) / dt) * momentumToVelocityFactor * factor; + this._draggedParticle.velocity.y = ((last.y - first.y) / dt) * momentumToVelocityFactor * factor; + } else if (this._savedVelocity) { + this._draggedParticle.velocity.x = this._savedVelocity.x; + this._draggedParticle.velocity.y = this._savedVelocity.y; + } + } else if (this._savedVelocity) { + this._draggedParticle.velocity.x = this._savedVelocity.x; + this._draggedParticle.velocity.y = this._savedVelocity.y; + } + } else if (this._savedVelocity) { + this._draggedParticle.velocity.x = this._savedVelocity.x; + this._draggedParticle.velocity.y = this._savedVelocity.y; + } + } + + this._draggedParticle = undefined; + this._dragStartClickTime = undefined; + this._dragStartClickingFalseTime = undefined; + this._grabOffset = undefined; + this._lastMousePosition = undefined; + this._momentumSamples = []; + this._savedVelocity = undefined; + } +} diff --git a/interactions/external/drag/src/Options/Classes/Drag.ts b/interactions/external/drag/src/Options/Classes/Drag.ts new file mode 100644 index 00000000000..4800fb1028d --- /dev/null +++ b/interactions/external/drag/src/Options/Classes/Drag.ts @@ -0,0 +1,32 @@ +import { type IOptionLoader, type RecursivePartial, isNull } from "@tsparticles/engine"; +import type { IDrag } from "../Interfaces/IDrag.js"; + +const defaultMomentumFactor = 0.03, + defaultPreserveMomentum = false; + +/** + * Options class for the drag interaction mode. + */ +export class Drag implements IDrag, IOptionLoader { + momentumFactor; + preserveMomentum; + + constructor() { + this.momentumFactor = defaultMomentumFactor; + this.preserveMomentum = defaultPreserveMomentum; + } + + load(data?: RecursivePartial): void { + if (isNull(data)) { + return; + } + + if (data.momentumFactor !== undefined) { + this.momentumFactor = data.momentumFactor; + } + + if (data.preserveMomentum !== undefined) { + this.preserveMomentum = data.preserveMomentum; + } + } +} diff --git a/interactions/external/drag/src/Options/Classes/DragOptions.ts b/interactions/external/drag/src/Options/Classes/DragOptions.ts new file mode 100644 index 00000000000..71b7205547b --- /dev/null +++ b/interactions/external/drag/src/Options/Classes/DragOptions.ts @@ -0,0 +1,8 @@ +import type { DragMode } from "../../Types.js"; +import type { InteractivityOptions } from "@tsparticles/plugin-interactivity"; + +export type DragOptions = InteractivityOptions & { + interactivity?: { + modes: DragMode; + }; +}; diff --git a/interactions/external/drag/src/Options/Interfaces/IDrag.ts b/interactions/external/drag/src/Options/Interfaces/IDrag.ts new file mode 100644 index 00000000000..fac4737c784 --- /dev/null +++ b/interactions/external/drag/src/Options/Interfaces/IDrag.ts @@ -0,0 +1,18 @@ +/** + * Options for the drag interaction mode. + */ +export interface IDrag { + /** + * Scaling factor applied to the computed drag velocity when {@link preserveMomentum} is enabled. + * Higher values result in a faster post-release movement. + * @defaultValue 0.03 + */ + momentumFactor: number; + + /** + * When `true`, the particle retains the velocity of the drag gesture on release + * instead of resuming the velocity it had before being grabbed. + * @defaultValue false + */ + preserveMomentum: boolean; +} diff --git a/interactions/external/drag/src/Types.ts b/interactions/external/drag/src/Types.ts new file mode 100644 index 00000000000..0016112bf3c --- /dev/null +++ b/interactions/external/drag/src/Types.ts @@ -0,0 +1,16 @@ +import type { Drag } from "./Options/Classes/Drag.js"; +import type { DragOptions } from "./Options/Classes/DragOptions.js"; +import type { IDrag } from "./Options/Interfaces/IDrag.js"; +import type { InteractivityContainer } from "@tsparticles/plugin-interactivity"; + +export interface IDragMode { + drag: IDrag; +} + +export interface DragMode { + drag?: Drag; +} + +export type DragContainer = InteractivityContainer & { + actualOptions: DragOptions; +}; diff --git a/interactions/external/drag/src/index.ts b/interactions/external/drag/src/index.ts new file mode 100644 index 00000000000..d05f4aa3ec3 --- /dev/null +++ b/interactions/external/drag/src/index.ts @@ -0,0 +1,30 @@ +import { type Engine } from "@tsparticles/engine"; +import type { InteractivityEngine } from "@tsparticles/plugin-interactivity"; + +export type { IDrag } from "./Options/Interfaces/IDrag.js"; +export type { DragContainer, DragMode, IDragMode } from "./Types.js"; +export { Drag } from "./Options/Classes/Drag.js"; + +declare const __VERSION__: string; + +/** + * Loads the external drag interaction into the given engine. + * After loading, particles can be clicked and dragged around the canvas + * by setting `interactivity.events.onClick.mode` to `"drag"`. + * @param engine - The engine to register the interaction into + */ +export async function loadExternalDragInteraction(engine: Engine): Promise { + engine.checkVersion(__VERSION__); + + await engine.register(async (e: InteractivityEngine) => { + const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity"); + + ensureInteractivityPluginLoaded(e); + + e.addInteractor?.("externalDrag", async container => { + const { Dragger } = await import("./Dragger.js"); + + return new Dragger(container); + }); + }); +} diff --git a/interactions/external/drag/tsconfig.base.json b/interactions/external/drag/tsconfig.base.json new file mode 100644 index 00000000000..deef1f14976 --- /dev/null +++ b/interactions/external/drag/tsconfig.base.json @@ -0,0 +1,10 @@ +{ + "extends": "@tsparticles/tsconfig/dist/tsconfig.base.json", + "compilerOptions": { + "rootDir": "./src" + }, + "include": [ + "./src" + ] +} + diff --git a/interactions/external/drag/tsconfig.browser.json b/interactions/external/drag/tsconfig.browser.json new file mode 100644 index 00000000000..824ce17c0fd --- /dev/null +++ b/interactions/external/drag/tsconfig.browser.json @@ -0,0 +1,7 @@ +{ + "extends": ["./tsconfig.base.json", "@tsparticles/tsconfig/dist/tsconfig.browser.json"], + "compilerOptions": { + "outDir": "./dist/browser" + } +} + diff --git a/interactions/external/drag/tsconfig.json b/interactions/external/drag/tsconfig.json new file mode 100644 index 00000000000..d29d546208c --- /dev/null +++ b/interactions/external/drag/tsconfig.json @@ -0,0 +1,7 @@ +{ + "extends": ["./tsconfig.base.json", "@tsparticles/tsconfig/dist/tsconfig.json"], + "compilerOptions": { + "outDir": "./dist/cjs" + } +} + diff --git a/interactions/external/drag/tsconfig.module.json b/interactions/external/drag/tsconfig.module.json new file mode 100644 index 00000000000..030719f2c21 --- /dev/null +++ b/interactions/external/drag/tsconfig.module.json @@ -0,0 +1,7 @@ +{ + "extends": ["./tsconfig.base.json", "@tsparticles/tsconfig/dist/tsconfig.module.json"], + "compilerOptions": { + "outDir": "./dist/esm" + } +} + diff --git a/interactions/external/drag/tsconfig.types.json b/interactions/external/drag/tsconfig.types.json new file mode 100644 index 00000000000..db4045ffaef --- /dev/null +++ b/interactions/external/drag/tsconfig.types.json @@ -0,0 +1,7 @@ +{ + "extends": ["./tsconfig.base.json", "@tsparticles/tsconfig/dist/tsconfig.types.json"], + "compilerOptions": { + "outDir": "./dist/types" + } +} + diff --git a/interactions/external/drag/tsconfig.umd.json b/interactions/external/drag/tsconfig.umd.json new file mode 100644 index 00000000000..17e1acb271d --- /dev/null +++ b/interactions/external/drag/tsconfig.umd.json @@ -0,0 +1,7 @@ +{ + "extends": ["./tsconfig.base.json", "@tsparticles/tsconfig/dist/tsconfig.umd.json"], + "compilerOptions": { + "outDir": "./dist/umd" + } +} + diff --git a/interactions/external/drag/typedoc.json b/interactions/external/drag/typedoc.json new file mode 100644 index 00000000000..7a189f8cbe0 --- /dev/null +++ b/interactions/external/drag/typedoc.json @@ -0,0 +1,16 @@ +{ + "projectDocuments": ["../markdown/**/*.md"], + "entryPoints": [ + "./src/" + ], + "entryPointStrategy": "expand", + "name": "tsParticles Drag External Interaction", + "includeVersion": true, + "hideGenerator": true, + "out": "./docs", + "validation": { + "invalidLink": true, + "notDocumented": true + } +} + diff --git a/interactions/external/drag/webpack.config.js b/interactions/external/drag/webpack.config.js new file mode 100644 index 00000000000..0d1c29a2b8c --- /dev/null +++ b/interactions/external/drag/webpack.config.js @@ -0,0 +1,19 @@ +import { loadParticlesInteractionExternal } from "@tsparticles/webpack-plugin"; +import { fileURLToPath } from "node:url"; +import fs from "fs-extra"; +import path from "node:path"; + +const __filename = fileURLToPath(import.meta.url), + __dirname = path.dirname(__filename), + rootPkgPath = path.join(__dirname, "package.json"), + pkg = await fs.readJson(rootPkgPath), + version = pkg.version; + +export default loadParticlesInteractionExternal({ + moduleName: "drag", + pluginName: "Drag", + version, + dir: __dirname, + progress: false, +}); + diff --git a/interactions/external/grab/CHANGELOG.md b/interactions/external/grab/CHANGELOG.md index 37de1e6b457..5a6263122b4 100644 --- a/interactions/external/grab/CHANGELOG.md +++ b/interactions/external/grab/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-grab + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-grab diff --git a/interactions/external/grab/package.dist.json b/interactions/external/grab/package.dist.json index 1d7eca7c9e6..37691a67919 100644 --- a/interactions/external/grab/package.dist.json +++ b/interactions/external/grab/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-grab", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles grab external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,9 +87,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/grab/package.json b/interactions/external/grab/package.json index 0ebdedf9e45..7c8ccb83de8 100644 --- a/interactions/external/grab/package.json +++ b/interactions/external/grab/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-grab", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles grab external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,9 +95,9 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/parallax/CHANGELOG.md b/interactions/external/parallax/CHANGELOG.md index bf7323c8e87..36aa49d6a0d 100644 --- a/interactions/external/parallax/CHANGELOG.md +++ b/interactions/external/parallax/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-parallax + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-parallax diff --git a/interactions/external/parallax/package.dist.json b/interactions/external/parallax/package.dist.json index 898a7835ef4..b03ee5a321f 100644 --- a/interactions/external/parallax/package.dist.json +++ b/interactions/external/parallax/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-parallax", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles parallax external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/parallax/package.json b/interactions/external/parallax/package.json index 0f7c74a6064..d91242fe9b2 100644 --- a/interactions/external/parallax/package.json +++ b/interactions/external/parallax/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-parallax", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles parallax external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/particle/CHANGELOG.md b/interactions/external/particle/CHANGELOG.md index d33c1c58d0c..7fdd6b1d1fc 100644 --- a/interactions/external/particle/CHANGELOG.md +++ b/interactions/external/particle/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-particle + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-particle diff --git a/interactions/external/particle/package.dist.json b/interactions/external/particle/package.dist.json index d7fcc4d2217..102cd195c49 100644 --- a/interactions/external/particle/package.dist.json +++ b/interactions/external/particle/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-particle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particle external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/particle/package.json b/interactions/external/particle/package.json index e2cf76d9b93..8a947fc9b0d 100644 --- a/interactions/external/particle/package.json +++ b/interactions/external/particle/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-particle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particle external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -67,8 +67,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/pause/CHANGELOG.md b/interactions/external/pause/CHANGELOG.md index b75288bcb78..3d0949814bd 100644 --- a/interactions/external/pause/CHANGELOG.md +++ b/interactions/external/pause/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-pause + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-pause diff --git a/interactions/external/pause/package.dist.json b/interactions/external/pause/package.dist.json index 68c6b138176..16bc2cbbe79 100644 --- a/interactions/external/pause/package.dist.json +++ b/interactions/external/pause/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-pause", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles pause external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/pause/package.json b/interactions/external/pause/package.json index 024428b2b45..8956fc47406 100644 --- a/interactions/external/pause/package.json +++ b/interactions/external/pause/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-pause", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles pause external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/pop/CHANGELOG.md b/interactions/external/pop/CHANGELOG.md index 4a93de75373..17480eaf42c 100644 --- a/interactions/external/pop/CHANGELOG.md +++ b/interactions/external/pop/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-pop + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-pop diff --git a/interactions/external/pop/package.dist.json b/interactions/external/pop/package.dist.json index fc9a8e6ddc7..0e20048b7a0 100644 --- a/interactions/external/pop/package.dist.json +++ b/interactions/external/pop/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-pop", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles pop external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/pop/package.json b/interactions/external/pop/package.json index 56db14bf51c..80caff0138d 100644 --- a/interactions/external/pop/package.json +++ b/interactions/external/pop/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-pop", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles pop external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/push/CHANGELOG.md b/interactions/external/push/CHANGELOG.md index 0543f675ca1..1ea9a657cd7 100644 --- a/interactions/external/push/CHANGELOG.md +++ b/interactions/external/push/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-push + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-push diff --git a/interactions/external/push/package.dist.json b/interactions/external/push/package.dist.json index 60c306b7523..3c1e808dea7 100644 --- a/interactions/external/push/package.dist.json +++ b/interactions/external/push/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-push", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles push external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/push/package.json b/interactions/external/push/package.json index f563269b7bb..85f64f7af14 100644 --- a/interactions/external/push/package.json +++ b/interactions/external/push/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-push", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles push external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/remove/CHANGELOG.md b/interactions/external/remove/CHANGELOG.md index 1cd4cc6c017..88e497888f2 100644 --- a/interactions/external/remove/CHANGELOG.md +++ b/interactions/external/remove/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-remove + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-remove diff --git a/interactions/external/remove/package.dist.json b/interactions/external/remove/package.dist.json index 115c403af64..fcdcf90541b 100644 --- a/interactions/external/remove/package.dist.json +++ b/interactions/external/remove/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-remove", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles remove external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/remove/package.json b/interactions/external/remove/package.json index bcafe5d7836..6337ba9da75 100644 --- a/interactions/external/remove/package.json +++ b/interactions/external/remove/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-remove", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles remove external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/repulse/CHANGELOG.md b/interactions/external/repulse/CHANGELOG.md index 35e5ac9a6af..e0b88c8b640 100644 --- a/interactions/external/repulse/CHANGELOG.md +++ b/interactions/external/repulse/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-repulse + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-repulse diff --git a/interactions/external/repulse/package.dist.json b/interactions/external/repulse/package.dist.json index 56c1853dc5c..b4b752cb20e 100644 --- a/interactions/external/repulse/package.dist.json +++ b/interactions/external/repulse/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-repulse", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles repulse external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/repulse/package.json b/interactions/external/repulse/package.json index 07022cf75ea..29c35b161f3 100644 --- a/interactions/external/repulse/package.json +++ b/interactions/external/repulse/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-repulse", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles repulse external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/slow/CHANGELOG.md b/interactions/external/slow/CHANGELOG.md index b3bd2df6f98..d78b843e7f1 100644 --- a/interactions/external/slow/CHANGELOG.md +++ b/interactions/external/slow/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-slow + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-slow diff --git a/interactions/external/slow/package.dist.json b/interactions/external/slow/package.dist.json index c9c12787adb..2ca53dd61a9 100644 --- a/interactions/external/slow/package.dist.json +++ b/interactions/external/slow/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-slow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles slow external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/slow/package.json b/interactions/external/slow/package.json index 449263f35e9..ba1e932248e 100644 --- a/interactions/external/slow/package.json +++ b/interactions/external/slow/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-slow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles slow external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/external/trail/CHANGELOG.md b/interactions/external/trail/CHANGELOG.md index efb0e6cf0a6..8e0ec39022b 100644 --- a/interactions/external/trail/CHANGELOG.md +++ b/interactions/external/trail/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-external-trail + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-external-trail diff --git a/interactions/external/trail/package.dist.json b/interactions/external/trail/package.dist.json index 28612cebb47..86682644688 100644 --- a/interactions/external/trail/package.dist.json +++ b/interactions/external/trail/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail external interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/external/trail/package.json b/interactions/external/trail/package.json index ea9c83aafbd..9bfb2fe5e92 100644 --- a/interactions/external/trail/package.json +++ b/interactions/external/trail/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-external-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail external interaction", "homepage": "https://particles.js.org", "scripts": { @@ -67,8 +67,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/light/CHANGELOG.md b/interactions/light/CHANGELOG.md index 63bfb13f802..07393218c44 100644 --- a/interactions/light/CHANGELOG.md +++ b/interactions/light/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-light + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-light diff --git a/interactions/light/package.dist.json b/interactions/light/package.dist.json index ad180eea5b9..cdd5b998d5d 100644 --- a/interactions/light/package.dist.json +++ b/interactions/light/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-light", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles Light interaction", "homepage": "https://particles.js.org", "repository": { @@ -101,8 +101,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/light/package.json b/interactions/light/package.json index 45a75472fdb..c612391a1bc 100644 --- a/interactions/light/package.json +++ b/interactions/light/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-light", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles Light interaction", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/particles/attract/CHANGELOG.md b/interactions/particles/attract/CHANGELOG.md index 3c30a28a1df..f9e01bd5560 100644 --- a/interactions/particles/attract/CHANGELOG.md +++ b/interactions/particles/attract/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-particles-attract + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-particles-attract diff --git a/interactions/particles/attract/package.dist.json b/interactions/particles/attract/package.dist.json index 2179664e35f..c0232d7284f 100644 --- a/interactions/particles/attract/package.dist.json +++ b/interactions/particles/attract/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-attract", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles attract particles interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/particles/attract/package.json b/interactions/particles/attract/package.json index 7eb8bc3384e..c9c76aa012d 100644 --- a/interactions/particles/attract/package.json +++ b/interactions/particles/attract/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-attract", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles attract particles interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/particles/collisions/CHANGELOG.md b/interactions/particles/collisions/CHANGELOG.md index f281c9745e9..5fdd163ac7a 100644 --- a/interactions/particles/collisions/CHANGELOG.md +++ b/interactions/particles/collisions/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-particles-collisions + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-particles-collisions diff --git a/interactions/particles/collisions/package.dist.json b/interactions/particles/collisions/package.dist.json index 5c53e909339..1ed7ecfdd19 100644 --- a/interactions/particles/collisions/package.dist.json +++ b/interactions/particles/collisions/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-collisions", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles collisions particles interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,8 +87,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/particles/collisions/package.json b/interactions/particles/collisions/package.json index 6fbce548791..41f4b1944ac 100644 --- a/interactions/particles/collisions/package.json +++ b/interactions/particles/collisions/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-collisions", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles collisions particles interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,8 +95,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/particles/links/CHANGELOG.md b/interactions/particles/links/CHANGELOG.md index a273ada4409..f83891509d1 100644 --- a/interactions/particles/links/CHANGELOG.md +++ b/interactions/particles/links/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-particles-links + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-particles-links diff --git a/interactions/particles/links/package.dist.json b/interactions/particles/links/package.dist.json index 74b635ec6d9..37cac17939c 100644 --- a/interactions/particles/links/package.dist.json +++ b/interactions/particles/links/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-links", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles links particles interaction", "homepage": "https://particles.js.org", "repository": { @@ -87,9 +87,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/particles/links/package.json b/interactions/particles/links/package.json index 564a2822780..e52c5b7b505 100644 --- a/interactions/particles/links/package.json +++ b/interactions/particles/links/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-links", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles links particles interaction", "homepage": "https://particles.js.org", "scripts": { @@ -95,9 +95,9 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/interactions/particles/repulse/CHANGELOG.md b/interactions/particles/repulse/CHANGELOG.md index f35a9bcba49..d7c7eb301db 100644 --- a/interactions/particles/repulse/CHANGELOG.md +++ b/interactions/particles/repulse/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/interaction-particles-repulse + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/interaction-particles-repulse diff --git a/interactions/particles/repulse/package.dist.json b/interactions/particles/repulse/package.dist.json index 1961f0052db..b1f5cea0324 100644 --- a/interactions/particles/repulse/package.dist.json +++ b/interactions/particles/repulse/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-repulse", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles repulse particles interaction", "homepage": "https://particles.js.org", "repository": { @@ -101,8 +101,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/interactions/particles/repulse/package.json b/interactions/particles/repulse/package.json index 554556b4314..941c794d355 100644 --- a/interactions/particles/repulse/package.json +++ b/interactions/particles/repulse/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/interaction-particles-repulse", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles repulse particles interaction", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/lerna.json b/lerna.json index 85937c37e1f..50342361d09 100644 --- a/lerna.json +++ b/lerna.json @@ -1,5 +1,5 @@ { - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "npmClient": "pnpm", "conventionalCommits": true, "command": { diff --git a/nx.json b/nx.json index 8961d3b21f9..6ad6e7383c7 100644 --- a/nx.json +++ b/nx.json @@ -5,21 +5,44 @@ "defaultBase": "main", "targetDefaults": { "build": { - "dependsOn": ["^build"], - "outputs": ["{projectRoot}/dist"], - "inputs": ["production", "^production"], + "dependsOn": [ + "^build" + ], + "outputs": [ + "{projectRoot}/dist" + ], + "inputs": [ + "production", + "^production" + ], "cache": true }, "build:ci": { - "dependsOn": ["^build:ci"], - "outputs": ["{projectRoot}/dist"], - "inputs": ["production", "^production"], + "dependsOn": [ + "^build:ci" + ], + "outputs": [ + "{projectRoot}/dist" + ], + "inputs": [ + "production", + "^production" + ], "cache": true }, "package": { - "dependsOn": ["^build", "^prepare", "^package"], - "outputs": ["{projectRoot}/dist"], - "inputs": ["production", "^production"], + "dependsOn": [ + "^build", + "^prepare", + "^package" + ], + "outputs": [ + "{projectRoot}/dist" + ], + "inputs": [ + "production", + "^production" + ], "cache": true } }, @@ -29,7 +52,10 @@ } }, "namedInputs": { - "default": ["{projectRoot}/**/*", "sharedGlobals"], + "default": [ + "{projectRoot}/**/*", + "sharedGlobals" + ], "sharedGlobals": [ "{workspaceRoot}/nx.json", "{workspaceRoot}/package.json", @@ -42,5 +68,6 @@ "{projectRoot}/tsconfig*.json", "sharedGlobals" ] - } + }, + "analytics": true } diff --git a/package.json b/package.json index eba15388f32..10a68a0e50f 100644 --- a/package.json +++ b/package.json @@ -28,15 +28,15 @@ }, "prettier": "@tsparticles/prettier-config", "devDependencies": { - "@commitlint/cli": "^20.4.4", - "@commitlint/config-conventional": "^20.4.4", + "@commitlint/cli": "^20.5.0", + "@commitlint/config-conventional": "^20.5.0", "@swc/core": "^1.15.18", - "@tsparticles/cli": "^3.3.6", - "@tsparticles/depcruise-config": "^3.3.3", - "@tsparticles/eslint-config": "^3.3.3", - "@tsparticles/prettier-config": "^3.3.3", - "@tsparticles/tsconfig": "^3.3.3", - "@tsparticles/webpack-plugin": "^3.3.3", + "@tsparticles/cli": "^3.3.8", + "@tsparticles/depcruise-config": "^3.3.5", + "@tsparticles/eslint-config": "^3.3.5", + "@tsparticles/prettier-config": "^3.3.5", + "@tsparticles/tsconfig": "^3.3.5", + "@tsparticles/webpack-plugin": "^3.3.5", "@types/jsdom": "^28.0.0", "@types/node": "^25.5.0", "@types/webpack-env": "^1.18.8", @@ -54,13 +54,13 @@ "fs-extra": "^11.3.4", "gh-pages": "^6.3.0", "husky": "^9.1.7", - "jsdom": "^28.1.0", + "jsdom": "^29.0.0", "jsdom-global": "^3.0.2", - "lerna": "^9.0.6", - "nx": "^22.5.4", + "lerna": "^9.0.7", + "nx": "^22.6.0", "nx-cloud": "^19.1.0", "prettier": "^3.8.1", - "prettier-plugin-multiline-arrays": "^4.1.4", + "prettier-plugin-multiline-arrays": "^4.1.5", "rimraf": "^6.1.3", "source-map-support": "^0.5.21", "swc-loader": "^0.2.7", @@ -75,12 +75,12 @@ "typedoc-plugin-mdn-links": "^5.1.1", "typedoc-plugin-missing-exports": "^4.1.2", "typescript": "^5.9.3", - "typescript-eslint": "^8.57.0", + "typescript-eslint": "^8.57.1", "typescript-json-schema": "^0.67.1", "vitest": "^4.1.0", "webpack": "^5.105.4", "webpack-bundle-analyzer": "^5.2.0", - "webpack-cli": "^6.0.1", + "webpack-cli": "^7.0.2", "yargs": "^18.0.0" }, "packageManager": "pnpm@10.32.1" diff --git a/paths/branches/CHANGELOG.md b/paths/branches/CHANGELOG.md index 1fb7469c0c7..5e5b0de969a 100644 --- a/paths/branches/CHANGELOG.md +++ b/paths/branches/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-branches + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-branches diff --git a/paths/branches/package.dist.json b/paths/branches/package.dist.json index dce754fca4e..a374de533d5 100644 --- a/paths/branches/package.dist.json +++ b/paths/branches/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-branches", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles branches path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/branches/package.json b/paths/branches/package.json index bb18777c8e5..2dba60b251c 100644 --- a/paths/branches/package.json +++ b/paths/branches/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-branches", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles branches path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/brownian/CHANGELOG.md b/paths/brownian/CHANGELOG.md index 529b0d9319b..6663d7b50ad 100644 --- a/paths/brownian/CHANGELOG.md +++ b/paths/brownian/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-brownian + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-brownian diff --git a/paths/brownian/package.dist.json b/paths/brownian/package.dist.json index f52a762bfdd..f18910c1812 100644 --- a/paths/brownian/package.dist.json +++ b/paths/brownian/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-brownian", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles brownian path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/brownian/package.json b/paths/brownian/package.json index 2deecf202c9..fb7e151d3cd 100644 --- a/paths/brownian/package.json +++ b/paths/brownian/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-brownian", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles brownian path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/curlNoise/CHANGELOG.md b/paths/curlNoise/CHANGELOG.md index 4e5bcd4c71e..8620daefbf1 100644 --- a/paths/curlNoise/CHANGELOG.md +++ b/paths/curlNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-curl-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-curl-noise diff --git a/paths/curlNoise/package.dist.json b/paths/curlNoise/package.dist.json index e3814f9011a..893161a8052 100644 --- a/paths/curlNoise/package.dist.json +++ b/paths/curlNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-curl-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles curl noise path", "homepage": "https://particles.js.org", "repository": { @@ -104,9 +104,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28", - "@tsparticles/simplex-noise": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0", + "@tsparticles/simplex-noise": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/curlNoise/package.json b/paths/curlNoise/package.json index 0f08df63d8c..945a32156e5 100644 --- a/paths/curlNoise/package.json +++ b/paths/curlNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-curl-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles curl noise path", "homepage": "https://particles.js.org", "scripts": { @@ -95,9 +95,9 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28", - "@tsparticles/simplex-noise": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0", + "@tsparticles/simplex-noise": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/curves/CHANGELOG.md b/paths/curves/CHANGELOG.md index 6c2f3787a5f..556fbd52981 100644 --- a/paths/curves/CHANGELOG.md +++ b/paths/curves/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-curves + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-curves diff --git a/paths/curves/package.dist.json b/paths/curves/package.dist.json index ef93be158c3..9e6afe1cc31 100644 --- a/paths/curves/package.dist.json +++ b/paths/curves/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-curves", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles curves path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/curves/package.json b/paths/curves/package.json index edec6f9247c..ecbfef6d2b2 100644 --- a/paths/curves/package.json +++ b/paths/curves/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-curves", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles curves path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/fractalNoise/CHANGELOG.md b/paths/fractalNoise/CHANGELOG.md index f887a8d3cfc..6663c24b4b1 100644 --- a/paths/fractalNoise/CHANGELOG.md +++ b/paths/fractalNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-fractal-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-fractal-noise diff --git a/paths/fractalNoise/package.dist.json b/paths/fractalNoise/package.dist.json index b5e6402c4e4..a040b164b03 100644 --- a/paths/fractalNoise/package.dist.json +++ b/paths/fractalNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-fractal-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles fractal noise path", "homepage": "https://particles.js.org", "repository": { @@ -104,10 +104,10 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/fractal-noise": "4.0.0-alpha.28", - "@tsparticles/noise-field": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/fractal-noise": "4.0.0-beta.0", + "@tsparticles/noise-field": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/fractalNoise/package.json b/paths/fractalNoise/package.json index 53dd3b8558d..b12e90fa5d4 100644 --- a/paths/fractalNoise/package.json +++ b/paths/fractalNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-fractal-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles fractal noise path", "homepage": "https://particles.js.org", "scripts": { @@ -109,10 +109,10 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/fractal-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/noise-field": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/fractal-noise": "workspace:4.0.0-beta.0", + "@tsparticles/noise-field": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/grid/CHANGELOG.md b/paths/grid/CHANGELOG.md index 25716bfb870..51cf752f213 100644 --- a/paths/grid/CHANGELOG.md +++ b/paths/grid/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-grid + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-grid diff --git a/paths/grid/package.dist.json b/paths/grid/package.dist.json index e101ba679d9..89d60d61a80 100644 --- a/paths/grid/package.dist.json +++ b/paths/grid/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-grid", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles grid path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/grid/package.json b/paths/grid/package.json index 027df3f39d5..9efbe1bdc34 100644 --- a/paths/grid/package.json +++ b/paths/grid/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-grid", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles grid path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/levy/CHANGELOG.md b/paths/levy/CHANGELOG.md index 587d45ec152..fb4a1b87312 100644 --- a/paths/levy/CHANGELOG.md +++ b/paths/levy/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-levy + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-levy diff --git a/paths/levy/package.dist.json b/paths/levy/package.dist.json index 374d6cd7025..c43761900a5 100644 --- a/paths/levy/package.dist.json +++ b/paths/levy/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-levy", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles levy path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/levy/package.json b/paths/levy/package.json index f964d64178b..0626f82131c 100644 --- a/paths/levy/package.json +++ b/paths/levy/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-levy", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles levy path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/perlinNoise/CHANGELOG.md b/paths/perlinNoise/CHANGELOG.md index 5d8635b7e33..fe4476d5d9f 100644 --- a/paths/perlinNoise/CHANGELOG.md +++ b/paths/perlinNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-perlin-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-perlin-noise diff --git a/paths/perlinNoise/package.dist.json b/paths/perlinNoise/package.dist.json index b1157fcd444..a5e68f743c1 100644 --- a/paths/perlinNoise/package.dist.json +++ b/paths/perlinNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-perlin-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles perlin noise path", "homepage": "https://particles.js.org", "repository": { @@ -104,10 +104,10 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/noise-field": "4.0.0-alpha.28", - "@tsparticles/perlin-noise": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/noise-field": "4.0.0-beta.0", + "@tsparticles/perlin-noise": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/perlinNoise/package.json b/paths/perlinNoise/package.json index 74ccc37153c..0e5752df287 100644 --- a/paths/perlinNoise/package.json +++ b/paths/perlinNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-perlin-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles perlin noise path", "homepage": "https://particles.js.org", "scripts": { @@ -109,10 +109,10 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/noise-field": "workspace:4.0.0-alpha.28", - "@tsparticles/perlin-noise": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/noise-field": "workspace:4.0.0-beta.0", + "@tsparticles/perlin-noise": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/polygon/CHANGELOG.md b/paths/polygon/CHANGELOG.md index f18af9245f8..8d55a64e50b 100644 --- a/paths/polygon/CHANGELOG.md +++ b/paths/polygon/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-polygon + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-polygon diff --git a/paths/polygon/package.dist.json b/paths/polygon/package.dist.json index 6bb91de2a33..05fdf006e4c 100644 --- a/paths/polygon/package.dist.json +++ b/paths/polygon/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/polygon/package.json b/paths/polygon/package.json index a6f3ee016c3..c978523119d 100644 --- a/paths/polygon/package.json +++ b/paths/polygon/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/random/CHANGELOG.md b/paths/random/CHANGELOG.md index 91ced70c39f..a6414d822c1 100644 --- a/paths/random/CHANGELOG.md +++ b/paths/random/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-random + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-random diff --git a/paths/random/package.dist.json b/paths/random/package.dist.json index fb06bf5b7d2..aa87eab7bfe 100644 --- a/paths/random/package.dist.json +++ b/paths/random/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-random", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zig zag path", "homepage": "https://particles.js.org", "repository": { @@ -101,8 +101,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/paths/random/package.json b/paths/random/package.json index cfdf18f0218..369aa684a48 100644 --- a/paths/random/package.json +++ b/paths/random/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-random", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zig zag path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/simplexNoise/CHANGELOG.md b/paths/simplexNoise/CHANGELOG.md index 7c2c31613d9..351adca6708 100644 --- a/paths/simplexNoise/CHANGELOG.md +++ b/paths/simplexNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-simplex-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-simplex-noise diff --git a/paths/simplexNoise/package.dist.json b/paths/simplexNoise/package.dist.json index 6ee0aae04a6..c6b06eb2408 100644 --- a/paths/simplexNoise/package.dist.json +++ b/paths/simplexNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-simplex-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles simplex noise path", "homepage": "https://particles.js.org", "repository": { @@ -104,10 +104,10 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/noise-field": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28", - "@tsparticles/simplex-noise": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/noise-field": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0", + "@tsparticles/simplex-noise": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/simplexNoise/package.json b/paths/simplexNoise/package.json index 755227fb8f7..1b2b521d14d 100644 --- a/paths/simplexNoise/package.json +++ b/paths/simplexNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-simplex-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles simplex noise path", "homepage": "https://particles.js.org", "scripts": { @@ -95,10 +95,10 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/noise-field": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28", - "@tsparticles/simplex-noise": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/noise-field": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0", + "@tsparticles/simplex-noise": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/spiral/CHANGELOG.md b/paths/spiral/CHANGELOG.md index 3cda53b06ca..f498300149f 100644 --- a/paths/spiral/CHANGELOG.md +++ b/paths/spiral/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-spiral + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-spiral diff --git a/paths/spiral/package.dist.json b/paths/spiral/package.dist.json index 720e078b1ec..33bc92cf561 100644 --- a/paths/spiral/package.dist.json +++ b/paths/spiral/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-spiral", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles spiral path", "homepage": "https://particles.js.org", "repository": { @@ -104,8 +104,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "type": "module" } diff --git a/paths/spiral/package.json b/paths/spiral/package.json index 135bb151f5a..2c4c5f2036c 100644 --- a/paths/spiral/package.json +++ b/paths/spiral/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-spiral", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles spiral path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/svg/CHANGELOG.md b/paths/svg/CHANGELOG.md index 7a5fa195d62..e2e64fd61e6 100644 --- a/paths/svg/CHANGELOG.md +++ b/paths/svg/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-svg + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-svg diff --git a/paths/svg/package.dist.json b/paths/svg/package.dist.json index 7ec2b22a1ad..0758e2cc9d2 100644 --- a/paths/svg/package.dist.json +++ b/paths/svg/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-svg", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles svg path", "homepage": "https://particles.js.org", "repository": { @@ -101,8 +101,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/paths/svg/package.json b/paths/svg/package.json index cc5126464c3..fab727ff356 100644 --- a/paths/svg/package.json +++ b/paths/svg/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-svg", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles svg path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/paths/zigzag/CHANGELOG.md b/paths/zigzag/CHANGELOG.md index e22bddd3a2b..77056543f9a 100644 --- a/paths/zigzag/CHANGELOG.md +++ b/paths/zigzag/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-zig-zag + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-zig-zag diff --git a/paths/zigzag/package.dist.json b/paths/zigzag/package.dist.json index 42aa1137c29..6e6ee91a93d 100644 --- a/paths/zigzag/package.dist.json +++ b/paths/zigzag/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-zig-zag", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zig zag path", "homepage": "https://particles.js.org", "repository": { @@ -101,8 +101,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/paths/zigzag/package.json b/paths/zigzag/package.json index f343bae9600..0718581a17b 100644 --- a/paths/zigzag/package.json +++ b/paths/zigzag/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-zig-zag", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zig zag path", "homepage": "https://particles.js.org", "scripts": { @@ -109,8 +109,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/absorbers/CHANGELOG.md b/plugins/absorbers/CHANGELOG.md index 3bca92d1939..a6dc6f97d5d 100644 --- a/plugins/absorbers/CHANGELOG.md +++ b/plugins/absorbers/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-absorbers + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-absorbers diff --git a/plugins/absorbers/package.dist.json b/plugins/absorbers/package.dist.json index bfed591e220..3b08f14f7b4 100644 --- a/plugins/absorbers/package.dist.json +++ b/plugins/absorbers/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-absorbers", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles absorbers plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,8 +86,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/absorbers/package.json b/plugins/absorbers/package.json index 832e943fa8b..846c7bc88c5 100644 --- a/plugins/absorbers/package.json +++ b/plugins/absorbers/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-absorbers", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles absorbers plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,8 +94,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/backgroundMask/CHANGELOG.md b/plugins/backgroundMask/CHANGELOG.md index b3011f36f86..6afda33fd82 100644 --- a/plugins/backgroundMask/CHANGELOG.md +++ b/plugins/backgroundMask/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-background-mask + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-background-mask diff --git a/plugins/backgroundMask/package.dist.json b/plugins/backgroundMask/package.dist.json index 4ed4c4863a6..eb7a2a8aa2e 100644 --- a/plugins/backgroundMask/package.dist.json +++ b/plugins/backgroundMask/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-background-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles background mask plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/backgroundMask/package.json b/plugins/backgroundMask/package.json index 34200b108a7..4a4f82e8a0d 100644 --- a/plugins/backgroundMask/package.json +++ b/plugins/backgroundMask/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-background-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles background mask plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/blend/CHANGELOG.md b/plugins/blend/CHANGELOG.md index e82c0ca47e4..575dbcd0e11 100644 --- a/plugins/blend/CHANGELOG.md +++ b/plugins/blend/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-blend + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-blend diff --git a/plugins/blend/package.dist.json b/plugins/blend/package.dist.json index 51bb2246c6d..26e5bf86c46 100644 --- a/plugins/blend/package.dist.json +++ b/plugins/blend/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-blend", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles blend plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/blend/package.json b/plugins/blend/package.json index be6f3c904e9..543af026fc8 100644 --- a/plugins/blend/package.json +++ b/plugins/blend/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-blend", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles blend plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/canvasMask/CHANGELOG.md b/plugins/canvasMask/CHANGELOG.md index 28a6837a91a..f5a4c995df6 100644 --- a/plugins/canvasMask/CHANGELOG.md +++ b/plugins/canvasMask/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-canvas-mask + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-canvas-mask diff --git a/plugins/canvasMask/package.dist.json b/plugins/canvasMask/package.dist.json index b123645256b..0a00880ed37 100644 --- a/plugins/canvasMask/package.dist.json +++ b/plugins/canvasMask/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-canvas-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles canvas mask plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,8 +86,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/canvasMask/package.json b/plugins/canvasMask/package.json index 74b08df29c0..300a756c96a 100644 --- a/plugins/canvasMask/package.json +++ b/plugins/canvasMask/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-canvas-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles canvas mask plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,8 +94,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/hex/CHANGELOG.md b/plugins/colors/hex/CHANGELOG.md index e7e6befa5cd..d5f2697e297 100644 --- a/plugins/colors/hex/CHANGELOG.md +++ b/plugins/colors/hex/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-hex-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-hex-color diff --git a/plugins/colors/hex/package.dist.json b/plugins/colors/hex/package.dist.json index ab8ef577a9e..191156c7bc3 100644 --- a/plugins/colors/hex/package.dist.json +++ b/plugins/colors/hex/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hex-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles hex color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/hex/package.json b/plugins/colors/hex/package.json index a95475a7df7..6afda7f2c12 100644 --- a/plugins/colors/hex/package.json +++ b/plugins/colors/hex/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hex-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles hex color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/hsl/CHANGELOG.md b/plugins/colors/hsl/CHANGELOG.md index fee6097437f..58f09611da3 100644 --- a/plugins/colors/hsl/CHANGELOG.md +++ b/plugins/colors/hsl/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-hsl-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-hsl-color diff --git a/plugins/colors/hsl/package.dist.json b/plugins/colors/hsl/package.dist.json index fad0fe3fcc4..2f6c05f2273 100644 --- a/plugins/colors/hsl/package.dist.json +++ b/plugins/colors/hsl/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hsl-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HSL color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/hsl/package.json b/plugins/colors/hsl/package.json index 10b6753a947..acb368e22cf 100644 --- a/plugins/colors/hsl/package.json +++ b/plugins/colors/hsl/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hsl-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HSL color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/hsv/CHANGELOG.md b/plugins/colors/hsv/CHANGELOG.md index 1139430de44..a9521125567 100644 --- a/plugins/colors/hsv/CHANGELOG.md +++ b/plugins/colors/hsv/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-hsv-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-hsv-color diff --git a/plugins/colors/hsv/package.dist.json b/plugins/colors/hsv/package.dist.json index 2a1335b077d..a94e035aaf1 100644 --- a/plugins/colors/hsv/package.dist.json +++ b/plugins/colors/hsv/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hsv-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HSV color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/hsv/package.json b/plugins/colors/hsv/package.json index b8ad012ab9e..7387919a86d 100644 --- a/plugins/colors/hsv/package.json +++ b/plugins/colors/hsv/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hsv-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HSV color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/hwb/CHANGELOG.md b/plugins/colors/hwb/CHANGELOG.md index 3e94f78129f..68bb69af56f 100644 --- a/plugins/colors/hwb/CHANGELOG.md +++ b/plugins/colors/hwb/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-hwb-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-hwb-color diff --git a/plugins/colors/hwb/package.dist.json b/plugins/colors/hwb/package.dist.json index f0064e6052d..5ac172fbd52 100644 --- a/plugins/colors/hwb/package.dist.json +++ b/plugins/colors/hwb/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hwb-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HWB color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/hwb/package.json b/plugins/colors/hwb/package.json index 0daf4abed42..570c7441210 100644 --- a/plugins/colors/hwb/package.json +++ b/plugins/colors/hwb/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-hwb-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles HWB color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/lab/CHANGELOG.md b/plugins/colors/lab/CHANGELOG.md index 3c97867e1f8..f6d447a06b7 100644 --- a/plugins/colors/lab/CHANGELOG.md +++ b/plugins/colors/lab/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-lab-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-lab-color diff --git a/plugins/colors/lab/package.dist.json b/plugins/colors/lab/package.dist.json index 79f434772c7..f148e710e44 100644 --- a/plugins/colors/lab/package.dist.json +++ b/plugins/colors/lab/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-lab-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles LAB color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/lab/package.json b/plugins/colors/lab/package.json index 57e4411e223..4eb5e194fcd 100644 --- a/plugins/colors/lab/package.json +++ b/plugins/colors/lab/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-lab-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles LAB color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/lch/CHANGELOG.md b/plugins/colors/lch/CHANGELOG.md index 3a49dafceb7..9eecfd18df1 100644 --- a/plugins/colors/lch/CHANGELOG.md +++ b/plugins/colors/lch/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-lch-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-lch-color diff --git a/plugins/colors/lch/package.dist.json b/plugins/colors/lch/package.dist.json index 0f97359f7b3..ae8fa0e950d 100644 --- a/plugins/colors/lch/package.dist.json +++ b/plugins/colors/lch/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-lch-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles LCH color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/lch/package.json b/plugins/colors/lch/package.json index b10f374de1a..123f9e11c5a 100644 --- a/plugins/colors/lch/package.json +++ b/plugins/colors/lch/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-lch-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles LCH color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/named/CHANGELOG.md b/plugins/colors/named/CHANGELOG.md index 8ba37f49a25..e8fcde0fb74 100644 --- a/plugins/colors/named/CHANGELOG.md +++ b/plugins/colors/named/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-named-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-named-color diff --git a/plugins/colors/named/package.dist.json b/plugins/colors/named/package.dist.json index 9d376772760..2422cf4b09d 100644 --- a/plugins/colors/named/package.dist.json +++ b/plugins/colors/named/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-named-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles named color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/named/package.json b/plugins/colors/named/package.json index 66f3e4d1939..f533b76d978 100644 --- a/plugins/colors/named/package.json +++ b/plugins/colors/named/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-named-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles named color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/oklab/CHANGELOG.md b/plugins/colors/oklab/CHANGELOG.md index 4a274066d7f..757dfe4a8b2 100644 --- a/plugins/colors/oklab/CHANGELOG.md +++ b/plugins/colors/oklab/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-oklab-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-oklab-color diff --git a/plugins/colors/oklab/package.dist.json b/plugins/colors/oklab/package.dist.json index 0c66725612d..5f06469aa77 100644 --- a/plugins/colors/oklab/package.dist.json +++ b/plugins/colors/oklab/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-oklab-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles OKLAB color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/oklab/package.json b/plugins/colors/oklab/package.json index f325a7874d0..55148d064a7 100644 --- a/plugins/colors/oklab/package.json +++ b/plugins/colors/oklab/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-oklab-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles OKLAB color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/oklch/CHANGELOG.md b/plugins/colors/oklch/CHANGELOG.md index a2844324aa5..255d16570ae 100644 --- a/plugins/colors/oklch/CHANGELOG.md +++ b/plugins/colors/oklch/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-oklch-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-oklch-color diff --git a/plugins/colors/oklch/package.dist.json b/plugins/colors/oklch/package.dist.json index 3e8bb7a2e4c..07a996dc18d 100644 --- a/plugins/colors/oklch/package.dist.json +++ b/plugins/colors/oklch/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-oklch-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles OKLCH color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/oklch/package.json b/plugins/colors/oklch/package.json index 214fe50a892..ec47b1c0568 100644 --- a/plugins/colors/oklch/package.json +++ b/plugins/colors/oklch/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-oklch-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles OKLCH color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/colors/rgb/CHANGELOG.md b/plugins/colors/rgb/CHANGELOG.md index d1684a04133..66c4acc33b9 100644 --- a/plugins/colors/rgb/CHANGELOG.md +++ b/plugins/colors/rgb/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-rgb-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-rgb-color diff --git a/plugins/colors/rgb/package.dist.json b/plugins/colors/rgb/package.dist.json index 629d3615a08..3bb25cd16d3 100644 --- a/plugins/colors/rgb/package.dist.json +++ b/plugins/colors/rgb/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-rgb-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles RGB color plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/colors/rgb/package.json b/plugins/colors/rgb/package.json index d7d9e16410d..ae6e38c641f 100644 --- a/plugins/colors/rgb/package.json +++ b/plugins/colors/rgb/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-rgb-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles RGB color plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/back/CHANGELOG.md b/plugins/easings/back/CHANGELOG.md index d3bb6c566df..73d177d4f97 100644 --- a/plugins/easings/back/CHANGELOG.md +++ b/plugins/easings/back/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-back + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-back diff --git a/plugins/easings/back/package.dist.json b/plugins/easings/back/package.dist.json index d554d099eae..e2353df8c73 100644 --- a/plugins/easings/back/package.dist.json +++ b/plugins/easings/back/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-back", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing back plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/back/package.json b/plugins/easings/back/package.json index 9fe289b1d5b..fa05a8ada0b 100644 --- a/plugins/easings/back/package.json +++ b/plugins/easings/back/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-back", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing back plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/bounce/CHANGELOG.md b/plugins/easings/bounce/CHANGELOG.md index 4057c57e329..7a712d7cfd6 100644 --- a/plugins/easings/bounce/CHANGELOG.md +++ b/plugins/easings/bounce/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-bounce + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-bounce diff --git a/plugins/easings/bounce/package.dist.json b/plugins/easings/bounce/package.dist.json index b1c13859215..8f661ba27f6 100644 --- a/plugins/easings/bounce/package.dist.json +++ b/plugins/easings/bounce/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-bounce", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing bounce plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/bounce/package.json b/plugins/easings/bounce/package.json index 2b7643deeca..935c9376061 100644 --- a/plugins/easings/bounce/package.json +++ b/plugins/easings/bounce/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-bounce", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing bounce plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/circ/CHANGELOG.md b/plugins/easings/circ/CHANGELOG.md index 57b4747b5f8..ebc5db4e07d 100644 --- a/plugins/easings/circ/CHANGELOG.md +++ b/plugins/easings/circ/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-circ + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-circ diff --git a/plugins/easings/circ/package.dist.json b/plugins/easings/circ/package.dist.json index 195b7cf4c08..d530298ea32 100644 --- a/plugins/easings/circ/package.dist.json +++ b/plugins/easings/circ/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-circ", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing circ plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/circ/package.json b/plugins/easings/circ/package.json index c5e81c4b580..5aba7d5d023 100644 --- a/plugins/easings/circ/package.json +++ b/plugins/easings/circ/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-circ", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing circ plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/cubic/CHANGELOG.md b/plugins/easings/cubic/CHANGELOG.md index 054ae3928c4..2f0e3ddded0 100644 --- a/plugins/easings/cubic/CHANGELOG.md +++ b/plugins/easings/cubic/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-cubic + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-cubic diff --git a/plugins/easings/cubic/package.dist.json b/plugins/easings/cubic/package.dist.json index d31a2860567..da145af498d 100644 --- a/plugins/easings/cubic/package.dist.json +++ b/plugins/easings/cubic/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-cubic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing cubic plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/cubic/package.json b/plugins/easings/cubic/package.json index a781b1348fc..ac8c0230030 100644 --- a/plugins/easings/cubic/package.json +++ b/plugins/easings/cubic/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-cubic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing cubic plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/elastic/CHANGELOG.md b/plugins/easings/elastic/CHANGELOG.md index d389f772ff7..a88f7b8b52d 100644 --- a/plugins/easings/elastic/CHANGELOG.md +++ b/plugins/easings/elastic/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-elastic + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-elastic diff --git a/plugins/easings/elastic/package.dist.json b/plugins/easings/elastic/package.dist.json index 29ca055b40c..c7d1c6c635f 100644 --- a/plugins/easings/elastic/package.dist.json +++ b/plugins/easings/elastic/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-elastic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing elastic plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/elastic/package.json b/plugins/easings/elastic/package.json index 3d3a2b03f0d..3b5ebef67f7 100644 --- a/plugins/easings/elastic/package.json +++ b/plugins/easings/elastic/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-elastic", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing elastic plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/expo/CHANGELOG.md b/plugins/easings/expo/CHANGELOG.md index 3e285e80974..11212590b00 100644 --- a/plugins/easings/expo/CHANGELOG.md +++ b/plugins/easings/expo/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-expo + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-expo diff --git a/plugins/easings/expo/package.dist.json b/plugins/easings/expo/package.dist.json index 86acaa76c86..56d8ca03d26 100644 --- a/plugins/easings/expo/package.dist.json +++ b/plugins/easings/expo/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-expo", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing expo plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/expo/package.json b/plugins/easings/expo/package.json index 7f59aa69c0e..40108f1d355 100644 --- a/plugins/easings/expo/package.json +++ b/plugins/easings/expo/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-expo", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing expo plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/gaussian/CHANGELOG.md b/plugins/easings/gaussian/CHANGELOG.md index 08aa7edec88..290893ab402 100644 --- a/plugins/easings/gaussian/CHANGELOG.md +++ b/plugins/easings/gaussian/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-gaussian + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-gaussian diff --git a/plugins/easings/gaussian/package.dist.json b/plugins/easings/gaussian/package.dist.json index 03e723d1e2b..cd984f769b4 100644 --- a/plugins/easings/gaussian/package.dist.json +++ b/plugins/easings/gaussian/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-gaussian", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing gaussian plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/gaussian/package.json b/plugins/easings/gaussian/package.json index b0d129a0e40..68f097b7182 100644 --- a/plugins/easings/gaussian/package.json +++ b/plugins/easings/gaussian/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-gaussian", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing gaussian plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/linear/CHANGELOG.md b/plugins/easings/linear/CHANGELOG.md index e2b1a960441..91a4a065845 100644 --- a/plugins/easings/linear/CHANGELOG.md +++ b/plugins/easings/linear/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-linear + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-linear diff --git a/plugins/easings/linear/package.dist.json b/plugins/easings/linear/package.dist.json index 89e6f6611aa..1e4d4303ad5 100644 --- a/plugins/easings/linear/package.dist.json +++ b/plugins/easings/linear/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-linear", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing linear plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/linear/package.json b/plugins/easings/linear/package.json index 78a517253ad..c444fb0c7f4 100644 --- a/plugins/easings/linear/package.json +++ b/plugins/easings/linear/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-linear", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing linear plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/quad/CHANGELOG.md b/plugins/easings/quad/CHANGELOG.md index e437ceaa600..9160be2849a 100644 --- a/plugins/easings/quad/CHANGELOG.md +++ b/plugins/easings/quad/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-quad + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-quad diff --git a/plugins/easings/quad/package.dist.json b/plugins/easings/quad/package.dist.json index 35c7d2b8f0f..169bc5e3d05 100644 --- a/plugins/easings/quad/package.dist.json +++ b/plugins/easings/quad/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quad", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quad plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/quad/package.json b/plugins/easings/quad/package.json index 421402416d5..2ef7211a964 100644 --- a/plugins/easings/quad/package.json +++ b/plugins/easings/quad/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quad", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quad plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/quart/CHANGELOG.md b/plugins/easings/quart/CHANGELOG.md index 7f0cf146450..72e3683dcde 100644 --- a/plugins/easings/quart/CHANGELOG.md +++ b/plugins/easings/quart/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-quart + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-quart diff --git a/plugins/easings/quart/package.dist.json b/plugins/easings/quart/package.dist.json index c5e283cce3b..109e0d70a96 100644 --- a/plugins/easings/quart/package.dist.json +++ b/plugins/easings/quart/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quart", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quart plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/quart/package.json b/plugins/easings/quart/package.json index a4b7fad51df..86506fe17dc 100644 --- a/plugins/easings/quart/package.json +++ b/plugins/easings/quart/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quart", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quart plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/quint/CHANGELOG.md b/plugins/easings/quint/CHANGELOG.md index fcefaae1a24..80eeb049f9d 100644 --- a/plugins/easings/quint/CHANGELOG.md +++ b/plugins/easings/quint/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-quint + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-quint diff --git a/plugins/easings/quint/package.dist.json b/plugins/easings/quint/package.dist.json index bbc133abf6b..1ceb80b6bc8 100644 --- a/plugins/easings/quint/package.dist.json +++ b/plugins/easings/quint/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quint", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quint plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/quint/package.json b/plugins/easings/quint/package.json index 9a2408160c6..8fc59342851 100644 --- a/plugins/easings/quint/package.json +++ b/plugins/easings/quint/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-quint", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing quint plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/sigmoid/CHANGELOG.md b/plugins/easings/sigmoid/CHANGELOG.md index a807c4ceac4..64bb6f14285 100644 --- a/plugins/easings/sigmoid/CHANGELOG.md +++ b/plugins/easings/sigmoid/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-sigmoid + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-sigmoid diff --git a/plugins/easings/sigmoid/package.dist.json b/plugins/easings/sigmoid/package.dist.json index 38508895845..6a57a3400df 100644 --- a/plugins/easings/sigmoid/package.dist.json +++ b/plugins/easings/sigmoid/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-sigmoid", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing sigmoid plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/sigmoid/package.json b/plugins/easings/sigmoid/package.json index f062a95e75b..3b561cc32e8 100644 --- a/plugins/easings/sigmoid/package.json +++ b/plugins/easings/sigmoid/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-sigmoid", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing sigmoid plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/sine/CHANGELOG.md b/plugins/easings/sine/CHANGELOG.md index 3d7e8e5d01a..33d1d70df3c 100644 --- a/plugins/easings/sine/CHANGELOG.md +++ b/plugins/easings/sine/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-sine + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-sine diff --git a/plugins/easings/sine/package.dist.json b/plugins/easings/sine/package.dist.json index c29a906d691..3abbf8488a9 100644 --- a/plugins/easings/sine/package.dist.json +++ b/plugins/easings/sine/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-sine", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing sine plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/sine/package.json b/plugins/easings/sine/package.json index 9c531d5704c..deb716880a9 100644 --- a/plugins/easings/sine/package.json +++ b/plugins/easings/sine/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-sine", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing sine plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/easings/smoothstep/CHANGELOG.md b/plugins/easings/smoothstep/CHANGELOG.md index be748ae69af..56b0779bd0d 100644 --- a/plugins/easings/smoothstep/CHANGELOG.md +++ b/plugins/easings/smoothstep/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-easing-smoothstep + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-easing-smoothstep diff --git a/plugins/easings/smoothstep/package.dist.json b/plugins/easings/smoothstep/package.dist.json index 3ecf4768286..4d5b07bc0be 100644 --- a/plugins/easings/smoothstep/package.dist.json +++ b/plugins/easings/smoothstep/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-smoothstep", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing smoothstep plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/easings/smoothstep/package.json b/plugins/easings/smoothstep/package.json index 0b293d4397c..cfb8fa4e9cc 100644 --- a/plugins/easings/smoothstep/package.json +++ b/plugins/easings/smoothstep/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-easing-smoothstep", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles easing smoothstep plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emitters/CHANGELOG.md b/plugins/emitters/CHANGELOG.md index 005696eedb5..5d3c58762ba 100644 --- a/plugins/emitters/CHANGELOG.md +++ b/plugins/emitters/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters diff --git a/plugins/emitters/package.dist.json b/plugins/emitters/package.dist.json index 60f05afdc2e..b6dfd3c9ebe 100644 --- a/plugins/emitters/package.dist.json +++ b/plugins/emitters/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,8 +86,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emitters/package.json b/plugins/emitters/package.json index 8462d8c8cbe..3aa75b2dadb 100644 --- a/plugins/emitters/package.json +++ b/plugins/emitters/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,8 +94,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emittersShapes/canvas/CHANGELOG.md b/plugins/emittersShapes/canvas/CHANGELOG.md index f118698a2a3..6a1c19560a6 100644 --- a/plugins/emittersShapes/canvas/CHANGELOG.md +++ b/plugins/emittersShapes/canvas/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters-shape-canvas + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters-shape-canvas diff --git a/plugins/emittersShapes/canvas/package.dist.json b/plugins/emittersShapes/canvas/package.dist.json index 1a461c17beb..9139c691350 100644 --- a/plugins/emittersShapes/canvas/package.dist.json +++ b/plugins/emittersShapes/canvas/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-canvas", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape canvas plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,9 +100,9 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emittersShapes/canvas/package.json b/plugins/emittersShapes/canvas/package.json index 0e09110a1a7..f7fdda79af2 100644 --- a/plugins/emittersShapes/canvas/package.json +++ b/plugins/emittersShapes/canvas/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-canvas", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape canvas plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,9 +108,9 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emittersShapes/circle/CHANGELOG.md b/plugins/emittersShapes/circle/CHANGELOG.md index 22501d735d2..d4b9f74a427 100644 --- a/plugins/emittersShapes/circle/CHANGELOG.md +++ b/plugins/emittersShapes/circle/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters-shape-circle + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters-shape-circle diff --git a/plugins/emittersShapes/circle/package.dist.json b/plugins/emittersShapes/circle/package.dist.json index cb0735b3c6b..0a28a97cbaf 100644 --- a/plugins/emittersShapes/circle/package.dist.json +++ b/plugins/emittersShapes/circle/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-circle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape circle plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emittersShapes/circle/package.json b/plugins/emittersShapes/circle/package.json index b6699599cfd..3f593c40e81 100644 --- a/plugins/emittersShapes/circle/package.json +++ b/plugins/emittersShapes/circle/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-circle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape circle plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emittersShapes/path/CHANGELOG.md b/plugins/emittersShapes/path/CHANGELOG.md index 32c338f191d..61dede3f28c 100644 --- a/plugins/emittersShapes/path/CHANGELOG.md +++ b/plugins/emittersShapes/path/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters-shape-path + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters-shape-path diff --git a/plugins/emittersShapes/path/package.dist.json b/plugins/emittersShapes/path/package.dist.json index 21aa648161b..1da6c0c70c3 100644 --- a/plugins/emittersShapes/path/package.dist.json +++ b/plugins/emittersShapes/path/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-path", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape path plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emittersShapes/path/package.json b/plugins/emittersShapes/path/package.json index 013f38b5772..56177d29864 100644 --- a/plugins/emittersShapes/path/package.json +++ b/plugins/emittersShapes/path/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-path", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape path plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emittersShapes/polygon/CHANGELOG.md b/plugins/emittersShapes/polygon/CHANGELOG.md index c2a4fbd2511..9b37f763018 100644 --- a/plugins/emittersShapes/polygon/CHANGELOG.md +++ b/plugins/emittersShapes/polygon/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters-shape-polygon + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters-shape-polygon diff --git a/plugins/emittersShapes/polygon/package.dist.json b/plugins/emittersShapes/polygon/package.dist.json index 9f9236a9159..d31f2c790b9 100644 --- a/plugins/emittersShapes/polygon/package.dist.json +++ b/plugins/emittersShapes/polygon/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape polygon plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emittersShapes/polygon/package.json b/plugins/emittersShapes/polygon/package.json index 151c77375fa..b6035a6a185 100644 --- a/plugins/emittersShapes/polygon/package.json +++ b/plugins/emittersShapes/polygon/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape polygon plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/emittersShapes/square/CHANGELOG.md b/plugins/emittersShapes/square/CHANGELOG.md index 344ba93b104..4a1c7a60a09 100644 --- a/plugins/emittersShapes/square/CHANGELOG.md +++ b/plugins/emittersShapes/square/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-emitters-shape-square + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-emitters-shape-square diff --git a/plugins/emittersShapes/square/package.dist.json b/plugins/emittersShapes/square/package.dist.json index 0c5f5054f56..5f24bb49134 100644 --- a/plugins/emittersShapes/square/package.dist.json +++ b/plugins/emittersShapes/square/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-square", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape square plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-emitters": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/emittersShapes/square/package.json b/plugins/emittersShapes/square/package.json index c6ad2a8a0de..01a4f58b6b7 100644 --- a/plugins/emittersShapes/square/package.json +++ b/plugins/emittersShapes/square/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-emitters-shape-square", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emitters shape square plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-emitters": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-emitters": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/exports/image/CHANGELOG.md b/plugins/exports/image/CHANGELOG.md index 9ebe8a6de88..1ff9b61dd74 100644 --- a/plugins/exports/image/CHANGELOG.md +++ b/plugins/exports/image/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-export-image + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-export-image diff --git a/plugins/exports/image/package.dist.json b/plugins/exports/image/package.dist.json index 28cc57e37be..a0530536264 100644 --- a/plugins/exports/image/package.dist.json +++ b/plugins/exports/image/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-image", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export image plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/exports/image/package.json b/plugins/exports/image/package.json index a7031d24634..53b7de4d495 100644 --- a/plugins/exports/image/package.json +++ b/plugins/exports/image/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-image", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export image plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/exports/json/CHANGELOG.md b/plugins/exports/json/CHANGELOG.md index 62c7acb1bff..65140178784 100644 --- a/plugins/exports/json/CHANGELOG.md +++ b/plugins/exports/json/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-export-json + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-export-json diff --git a/plugins/exports/json/package.dist.json b/plugins/exports/json/package.dist.json index d98ebd096e6..6ced1ad3f7f 100644 --- a/plugins/exports/json/package.dist.json +++ b/plugins/exports/json/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-json", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export json plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/exports/json/package.json b/plugins/exports/json/package.json index b0a9a661dc1..e16afad2486 100644 --- a/plugins/exports/json/package.json +++ b/plugins/exports/json/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-json", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export json plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/exports/video/CHANGELOG.md b/plugins/exports/video/CHANGELOG.md index cd69373f530..64d1dd2b65f 100644 --- a/plugins/exports/video/CHANGELOG.md +++ b/plugins/exports/video/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-export-video + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-export-video diff --git a/plugins/exports/video/package.dist.json b/plugins/exports/video/package.dist.json index 79f5f34b558..ba25ba9da3d 100644 --- a/plugins/exports/video/package.dist.json +++ b/plugins/exports/video/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-video", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export video plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/exports/video/package.json b/plugins/exports/video/package.json index ad6eb3a0028..b0c25e2fd49 100644 --- a/plugins/exports/video/package.json +++ b/plugins/exports/video/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-export-video", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles export video plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/infection/CHANGELOG.md b/plugins/infection/CHANGELOG.md index 1acf43bf716..348667fd78b 100644 --- a/plugins/infection/CHANGELOG.md +++ b/plugins/infection/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-infection + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-infection diff --git a/plugins/infection/package.dist.json b/plugins/infection/package.dist.json index 81484dec600..9ef68d79dbe 100644 --- a/plugins/infection/package.dist.json +++ b/plugins/infection/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-infection", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles infection plugin", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/infection/package.json b/plugins/infection/package.json index 29d00cb7348..90902e5d8f2 100644 --- a/plugins/infection/package.json +++ b/plugins/infection/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-infection", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles infection plugin", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-interactivity": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-interactivity": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/interactivity/CHANGELOG.md b/plugins/interactivity/CHANGELOG.md index 590b7568725..5d62ae3553e 100644 --- a/plugins/interactivity/CHANGELOG.md +++ b/plugins/interactivity/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-interactivity + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-interactivity diff --git a/plugins/interactivity/package.dist.json b/plugins/interactivity/package.dist.json index 0677eea3409..4be1751cca5 100644 --- a/plugins/interactivity/package.dist.json +++ b/plugins/interactivity/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-interactivity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles interactivity sickness plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/interactivity/package.json b/plugins/interactivity/package.json index 72661d5ffd0..d9bd38f9dc8 100644 --- a/plugins/interactivity/package.json +++ b/plugins/interactivity/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-interactivity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles interactivity sickness plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/interactivity/src/InteractionManager.ts b/plugins/interactivity/src/InteractionManager.ts index bee40a59a4e..85c897eac3e 100644 --- a/plugins/interactivity/src/InteractionManager.ts +++ b/plugins/interactivity/src/InteractionManager.ts @@ -3,10 +3,7 @@ import { type ICoordinates, type IDelta, type Particle, - clickRadius, - minCoordinate, safeIntersectionObserver, - touchEndLengthOffset, } from "@tsparticles/engine"; import { clickEvent, @@ -23,6 +20,10 @@ import type { InteractivityEngine } from "./types.js"; import { InteractivityEventListeners } from "./InteractivityEventListeners.js"; import { InteractorType } from "./Enums/InteractorType.js"; +const clickRadius = 1, + touchEndLengthOffset = 1, + minCoordinate = 0; + type ContainerClickHandler = (evt: Event) => void; export class InteractionManager { diff --git a/plugins/interactivity/src/InteractivityEventListeners.ts b/plugins/interactivity/src/InteractivityEventListeners.ts index 9a39605bf1d..f7542900b89 100644 --- a/plugins/interactivity/src/InteractivityEventListeners.ts +++ b/plugins/interactivity/src/InteractivityEventListeners.ts @@ -5,7 +5,6 @@ import { executeOnSingleOrMultiple, lengthOffset, manageListener, - touchDelay, visibilityChangeEvent, } from "@tsparticles/engine"; import { @@ -23,6 +22,8 @@ import type { InteractionManager } from "./InteractionManager.js"; import type { InteractivityContainer } from "./types.js"; import { InteractivityDetect } from "./Enums/InteractivityDetect.js"; +const touchDelay = 500; + interface InteractivityEventListenersHandlers { readonly mouseDown: EventListenerOrEventListenerObject; readonly mouseLeave: EventListenerOrEventListenerObject; diff --git a/plugins/manualParticles/CHANGELOG.md b/plugins/manualParticles/CHANGELOG.md index 43ae739d804..e78392ff03d 100644 --- a/plugins/manualParticles/CHANGELOG.md +++ b/plugins/manualParticles/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-manual-particles + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-manual-particles diff --git a/plugins/manualParticles/package.dist.json b/plugins/manualParticles/package.dist.json index ff90a5b88b3..b3da11dbcb6 100644 --- a/plugins/manualParticles/package.dist.json +++ b/plugins/manualParticles/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-manual-particles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles manual particles plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/manualParticles/package.json b/plugins/manualParticles/package.json index 91eb33e0106..786d2c38de0 100644 --- a/plugins/manualParticles/package.json +++ b/plugins/manualParticles/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-manual-particles", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles manual particles plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/manualParticles/src/Options/Classes/ManualParticle.ts b/plugins/manualParticles/src/Options/Classes/ManualParticle.ts index 8acddecdf43..d71612d7141 100644 --- a/plugins/manualParticles/src/Options/Classes/ManualParticle.ts +++ b/plugins/manualParticles/src/Options/Classes/ManualParticle.ts @@ -6,10 +6,11 @@ import { type RecursivePartial, deepExtend, isNull, - manualDefaultPosition, } from "@tsparticles/engine"; import type { IManualParticle } from "../Interfaces/IManualParticle.js"; +const manualDefaultPosition = 50; + export class ManualParticle implements IManualParticle, IOptionLoader { options?: RecursivePartial; position?: ICoordinatesWithMode; diff --git a/plugins/motion/CHANGELOG.md b/plugins/motion/CHANGELOG.md index 38bef42f543..c64a439b79e 100644 --- a/plugins/motion/CHANGELOG.md +++ b/plugins/motion/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-motion + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-motion diff --git a/plugins/motion/package.dist.json b/plugins/motion/package.dist.json index 7aaa6c59895..027742b723d 100644 --- a/plugins/motion/package.dist.json +++ b/plugins/motion/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-motion", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles motion sickness plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/motion/package.json b/plugins/motion/package.json index 7e764c498ba..c3414c79f5e 100644 --- a/plugins/motion/package.json +++ b/plugins/motion/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-motion", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles motion sickness plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/move/CHANGELOG.md b/plugins/move/CHANGELOG.md index 2711b18ca18..4e3bf84ac7a 100644 --- a/plugins/move/CHANGELOG.md +++ b/plugins/move/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-move + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-move diff --git a/plugins/move/package.dist.json b/plugins/move/package.dist.json index 574c51803c9..c6024de6ffc 100644 --- a/plugins/move/package.dist.json +++ b/plugins/move/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-move", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles Move plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/move/package.json b/plugins/move/package.json index 46abc665495..e57cabc9f8c 100644 --- a/plugins/move/package.json +++ b/plugins/move/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-move", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles Move plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/poisson/CHANGELOG.md b/plugins/poisson/CHANGELOG.md index 571865b65ce..088f88b577a 100644 --- a/plugins/poisson/CHANGELOG.md +++ b/plugins/poisson/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-poisson-disc + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-poisson-disc diff --git a/plugins/poisson/package.dist.json b/plugins/poisson/package.dist.json index 32a34530473..90389f6d4d4 100644 --- a/plugins/poisson/package.dist.json +++ b/plugins/poisson/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-poisson-disc", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles poisson disc plugin", "homepage": "https://particles.js.org", "repository": { @@ -85,7 +85,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/poisson/package.json b/plugins/poisson/package.json index 40c994e7af5..490d3ee7277 100644 --- a/plugins/poisson/package.json +++ b/plugins/poisson/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-poisson-disc", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles poisson disc plugin", "homepage": "https://particles.js.org", "scripts": { @@ -78,7 +78,7 @@ "types": "dist/types/index.d.ts", "prettier": "@tsparticles/prettier-config", "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/polygonMask/CHANGELOG.md b/plugins/polygonMask/CHANGELOG.md index 391147c9953..9e40a154d5f 100644 --- a/plugins/polygonMask/CHANGELOG.md +++ b/plugins/polygonMask/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-polygon-mask + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-polygon-mask diff --git a/plugins/polygonMask/package.dist.json b/plugins/polygonMask/package.dist.json index e60f24c8715..4b9277d5b07 100644 --- a/plugins/polygonMask/package.dist.json +++ b/plugins/polygonMask/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-polygon-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon mask plugin", "homepage": "https://particles.js.org", "repository": { @@ -88,7 +88,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/polygonMask/package.json b/plugins/polygonMask/package.json index b309949bd17..bd38b37e853 100644 --- a/plugins/polygonMask/package.json +++ b/plugins/polygonMask/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-polygon-mask", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon mask plugin", "homepage": "https://particles.js.org", "scripts": { @@ -81,7 +81,7 @@ "dist/**/pathseg.js" ], "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/responsive/CHANGELOG.md b/plugins/responsive/CHANGELOG.md index 1960e5d1fc1..5ee702a087e 100644 --- a/plugins/responsive/CHANGELOG.md +++ b/plugins/responsive/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-responsive + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-responsive diff --git a/plugins/responsive/package.dist.json b/plugins/responsive/package.dist.json index f69a3ad7fac..c997521061e 100644 --- a/plugins/responsive/package.dist.json +++ b/plugins/responsive/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-responsive", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles responsive plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/responsive/package.json b/plugins/responsive/package.json index e1fb99a69b2..63dddfd26a2 100644 --- a/plugins/responsive/package.json +++ b/plugins/responsive/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-responsive", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles responsive plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/sounds/CHANGELOG.md b/plugins/sounds/CHANGELOG.md index 62779fc21de..5f297357bcc 100644 --- a/plugins/sounds/CHANGELOG.md +++ b/plugins/sounds/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-sounds + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-sounds diff --git a/plugins/sounds/package.dist.json b/plugins/sounds/package.dist.json index f537a51f692..6f8034e4938 100644 --- a/plugins/sounds/package.dist.json +++ b/plugins/sounds/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-sounds", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles sounds plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/sounds/package.json b/plugins/sounds/package.json index 1e17a6ed5b0..651e98cbc59 100644 --- a/plugins/sounds/package.json +++ b/plugins/sounds/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-sounds", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles sounds plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/themes/CHANGELOG.md b/plugins/themes/CHANGELOG.md index 9bd6153c526..dda0f37b106 100644 --- a/plugins/themes/CHANGELOG.md +++ b/plugins/themes/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-themes + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-themes diff --git a/plugins/themes/package.dist.json b/plugins/themes/package.dist.json index 82dfbc075c0..9d90894aeb9 100644 --- a/plugins/themes/package.dist.json +++ b/plugins/themes/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-themes", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles themes plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/themes/package.json b/plugins/themes/package.json index dcb48514f52..145a74e60f7 100644 --- a/plugins/themes/package.json +++ b/plugins/themes/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-themes", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles themes plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/trail/CHANGELOG.md b/plugins/trail/CHANGELOG.md index 259a704db97..f5b190855d9 100644 --- a/plugins/trail/CHANGELOG.md +++ b/plugins/trail/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-trail + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-trail diff --git a/plugins/trail/package.dist.json b/plugins/trail/package.dist.json index 522359e8fb9..86aa212f888 100644 --- a/plugins/trail/package.dist.json +++ b/plugins/trail/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/trail/package.json b/plugins/trail/package.json index bd4f133e609..a3852702410 100644 --- a/plugins/trail/package.json +++ b/plugins/trail/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-trail", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles trail plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/plugins/zoom/CHANGELOG.md b/plugins/zoom/CHANGELOG.md index d20a9a3d390..20064ae4f55 100644 --- a/plugins/zoom/CHANGELOG.md +++ b/plugins/zoom/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/plugin-zoom + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/plugin-zoom diff --git a/plugins/zoom/package.dist.json b/plugins/zoom/package.dist.json index 5b8c8d74cf2..6e5563773a3 100644 --- a/plugins/zoom/package.dist.json +++ b/plugins/zoom/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-zoom", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zoom plugin", "homepage": "https://particles.js.org", "repository": { @@ -86,7 +86,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/plugins/zoom/package.json b/plugins/zoom/package.json index cdec13db3de..3ba6dd3dc1a 100644 --- a/plugins/zoom/package.json +++ b/plugins/zoom/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/plugin-zoom", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles zoom plugin", "homepage": "https://particles.js.org", "scripts": { @@ -94,7 +94,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 7ede527d7dc..87418907bd4 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -8,32 +8,32 @@ importers: .: devDependencies: "@commitlint/cli": - specifier: ^20.4.4 - version: 20.4.4(@types/node@25.5.0)(conventional-commits-parser@6.3.0)(typescript@5.9.3) + specifier: ^20.5.0 + version: 20.5.0(@types/node@25.5.0)(conventional-commits-parser@6.3.0)(typescript@5.9.3) "@commitlint/config-conventional": - specifier: ^20.4.4 - version: 20.4.4 + specifier: ^20.5.0 + version: 20.5.0 "@swc/core": specifier: ^1.15.18 version: 1.15.18 "@tsparticles/cli": - specifier: ^3.3.6 - version: 3.3.6(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)(webpack-cli@6.0.1) + specifier: ^3.3.8 + version: 3.3.8(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)(webpack-cli@7.0.2) "@tsparticles/depcruise-config": - specifier: ^3.3.3 - version: 3.3.3(dependency-cruiser@17.3.9) + specifier: ^3.3.5 + version: 3.3.5(dependency-cruiser@17.3.9) "@tsparticles/eslint-config": - specifier: ^3.3.3 - version: 3.3.3(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) + specifier: ^3.3.5 + version: 3.3.5(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) "@tsparticles/prettier-config": - specifier: ^3.3.3 - version: 3.3.3(prettier@3.8.1) + specifier: ^3.3.5 + version: 3.3.5(prettier@3.8.1) "@tsparticles/tsconfig": - specifier: ^3.3.3 - version: 3.3.3(typescript@5.9.3) + specifier: ^3.3.5 + version: 3.3.5(typescript@5.9.3) "@tsparticles/webpack-plugin": - specifier: ^3.3.3 - version: 3.3.3(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1) + specifier: ^3.3.5 + version: 3.3.5(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1) "@types/jsdom": specifier: ^28.0.0 version: 28.0.0 @@ -86,17 +86,17 @@ importers: specifier: ^9.1.7 version: 9.1.7 jsdom: - specifier: ^28.1.0 - version: 28.1.0(canvas@3.2.1) + specifier: ^29.0.0 + version: 29.0.0(canvas@3.2.1) jsdom-global: specifier: ^3.0.2 - version: 3.0.2(jsdom@28.1.0(canvas@3.2.1)) + version: 3.0.2(jsdom@29.0.0(canvas@3.2.1)) lerna: - specifier: ^9.0.6 - version: 9.0.6(@swc/core@1.15.18)(@types/node@25.5.0) + specifier: ^9.0.7 + version: 9.0.7(@swc/core@1.15.18)(@types/node@25.5.0) nx: - specifier: ^22.5.4 - version: 22.5.4(@swc/core@1.15.18) + specifier: ^22.6.0 + version: 22.6.0(@swc/core@1.15.18) nx-cloud: specifier: ^19.1.0 version: 19.1.0 @@ -104,8 +104,8 @@ importers: specifier: ^3.8.1 version: 3.8.1 prettier-plugin-multiline-arrays: - specifier: ^4.1.4 - version: 4.1.4(prettier@3.8.1) + specifier: ^4.1.5 + version: 4.1.5(prettier@3.8.1) rimraf: specifier: ^6.1.3 version: 6.1.3 @@ -149,23 +149,23 @@ importers: specifier: ^5.9.3 version: 5.9.3 typescript-eslint: - specifier: ^8.57.0 - version: 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + specifier: ^8.57.1 + version: 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) typescript-json-schema: specifier: ^0.67.1 version: 0.67.1(@swc/core@1.15.18) vitest: specifier: ^4.1.0 - version: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@28.1.0(canvas@3.2.1))(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) + version: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@29.0.0(canvas@3.2.1))(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) webpack: specifier: ^5.105.4 - version: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + version: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) webpack-bundle-analyzer: specifier: ^5.2.0 version: 5.2.0 webpack-cli: - specifier: ^6.0.1 - version: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) + specifier: ^7.0.2 + version: 7.0.2(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) yargs: specifier: ^18.0.0 version: 18.0.0 @@ -173,919 +173,925 @@ importers: bundles/all: dependencies: "@tsparticles/effect-bubble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/bubble/dist "@tsparticles/effect-particles": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/particles/dist "@tsparticles/effect-shadow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/shadow/dist "@tsparticles/effect-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/trail/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/interaction-external-particle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/particle/dist "@tsparticles/interaction-external-pop": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/pop/dist "@tsparticles/interaction-light": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/light/dist "@tsparticles/interaction-particles-repulse": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/repulse/dist "@tsparticles/path-branches": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/branches/dist "@tsparticles/path-brownian": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/brownian/dist "@tsparticles/path-curl-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/curlNoise/dist "@tsparticles/path-curves": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/curves/dist "@tsparticles/path-fractal-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/fractalNoise/dist "@tsparticles/path-grid": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/grid/dist "@tsparticles/path-levy": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/levy/dist "@tsparticles/path-perlin-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/perlinNoise/dist "@tsparticles/path-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/polygon/dist "@tsparticles/path-random": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/random/dist "@tsparticles/path-simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/simplexNoise/dist "@tsparticles/path-spiral": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/spiral/dist "@tsparticles/path-svg": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/svg/dist "@tsparticles/path-zig-zag": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/zigzag/dist "@tsparticles/plugin-background-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/backgroundMask/dist "@tsparticles/plugin-blend": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/blend/dist "@tsparticles/plugin-canvas-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/canvasMask/dist "@tsparticles/plugin-easing-back": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/back/dist "@tsparticles/plugin-easing-bounce": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/bounce/dist "@tsparticles/plugin-easing-circ": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/circ/dist "@tsparticles/plugin-easing-cubic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/cubic/dist "@tsparticles/plugin-easing-elastic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/elastic/dist "@tsparticles/plugin-easing-expo": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/expo/dist "@tsparticles/plugin-easing-gaussian": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/gaussian/dist "@tsparticles/plugin-easing-linear": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/linear/dist "@tsparticles/plugin-easing-quart": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quart/dist "@tsparticles/plugin-easing-quint": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quint/dist "@tsparticles/plugin-easing-sigmoid": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/sigmoid/dist "@tsparticles/plugin-easing-sine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/sine/dist "@tsparticles/plugin-easing-smoothstep": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/smoothstep/dist "@tsparticles/plugin-emitters-shape-canvas": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/canvas/dist "@tsparticles/plugin-emitters-shape-path": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/path/dist "@tsparticles/plugin-emitters-shape-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/polygon/dist "@tsparticles/plugin-export-image": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/image/dist "@tsparticles/plugin-export-json": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/json/dist "@tsparticles/plugin-export-video": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/video/dist "@tsparticles/plugin-hsv-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsv/dist "@tsparticles/plugin-hwb-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hwb/dist "@tsparticles/plugin-infection": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/infection/dist "@tsparticles/plugin-lab-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/lab/dist "@tsparticles/plugin-lch-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/lch/dist "@tsparticles/plugin-manual-particles": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/manualParticles/dist "@tsparticles/plugin-motion": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/motion/dist "@tsparticles/plugin-named-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/named/dist "@tsparticles/plugin-oklab-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/oklab/dist "@tsparticles/plugin-oklch-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/oklch/dist "@tsparticles/plugin-poisson-disc": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/poisson/dist "@tsparticles/plugin-polygon-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/polygonMask/dist "@tsparticles/plugin-responsive": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/responsive/dist "@tsparticles/plugin-sounds": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/sounds/dist "@tsparticles/plugin-themes": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/themes/dist "@tsparticles/plugin-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/trail/dist "@tsparticles/plugin-zoom": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/zoom/dist "@tsparticles/shape-arrow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/arrow/dist "@tsparticles/shape-cards": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/cards/dist "@tsparticles/shape-cog": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/cog/dist "@tsparticles/shape-heart": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/heart/dist "@tsparticles/shape-infinity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/infinity/dist "@tsparticles/shape-matrix": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/matrix/dist "@tsparticles/shape-path": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/path/dist "@tsparticles/shape-rounded-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/rounded-polygon/dist "@tsparticles/shape-rounded-rect": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/rounded-rect/dist "@tsparticles/shape-spiral": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/spiral/dist "@tsparticles/shape-squircle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/squircle/dist "@tsparticles/updater-gradient": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/gradient/dist "@tsparticles/updater-orbit": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/orbit/dist tsparticles: - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../full/dist publishDirectory: dist bundles/basic: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-hex-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hex/dist "@tsparticles/plugin-hsl-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsl/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist "@tsparticles/plugin-rgb-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/rgb/dist "@tsparticles/shape-circle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/circle/dist "@tsparticles/updater-fill-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/fillColor/dist "@tsparticles/updater-opacity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/opacity/dist "@tsparticles/updater-out-modes": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/outModes/dist "@tsparticles/updater-size": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/size/dist publishDirectory: dist bundles/confetti: dependencies: "@tsparticles/basic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../basic/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emitters/dist "@tsparticles/plugin-motion": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/motion/dist "@tsparticles/shape-cards": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/cards/dist "@tsparticles/shape-emoji": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/emoji/dist "@tsparticles/shape-heart": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/heart/dist "@tsparticles/shape-image": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/image/dist "@tsparticles/shape-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/polygon/dist "@tsparticles/shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/square/dist "@tsparticles/shape-star": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/star/dist "@tsparticles/updater-life": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/life/dist "@tsparticles/updater-roll": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/roll/dist "@tsparticles/updater-rotate": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/rotate/dist "@tsparticles/updater-tilt": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/tilt/dist "@tsparticles/updater-wobble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/wobble/dist publishDirectory: dist bundles/fireworks: dependencies: "@tsparticles/basic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../basic/dist "@tsparticles/effect-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/trail/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emitters/dist "@tsparticles/plugin-emitters-shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/square/dist "@tsparticles/plugin-sounds": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/sounds/dist "@tsparticles/updater-destroy": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/destroy/dist "@tsparticles/updater-life": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/life/dist "@tsparticles/updater-rotate": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/rotate/dist publishDirectory: dist bundles/full: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist + "@tsparticles/interaction-external-drag": + specifier: workspace:4.0.0-beta.0 + version: link:../../interactions/external/drag/dist "@tsparticles/interaction-external-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/trail/dist "@tsparticles/plugin-absorbers": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/absorbers/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emitters/dist "@tsparticles/plugin-emitters-shape-circle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/circle/dist "@tsparticles/plugin-emitters-shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/square/dist "@tsparticles/shape-text": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/text/dist "@tsparticles/slim": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../slim/dist "@tsparticles/updater-destroy": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/destroy/dist "@tsparticles/updater-roll": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/roll/dist "@tsparticles/updater-tilt": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/tilt/dist "@tsparticles/updater-twinkle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/twinkle/dist "@tsparticles/updater-wobble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/wobble/dist publishDirectory: dist bundles/pjs: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-responsive": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/responsive/dist tsparticles: - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../full/dist devDependencies: "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/interactivity/dist publishDirectory: dist bundles/slim: dependencies: "@tsparticles/basic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../basic/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/interaction-external-attract": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/attract/dist "@tsparticles/interaction-external-bounce": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/bounce/dist "@tsparticles/interaction-external-bubble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/bubble/dist "@tsparticles/interaction-external-connect": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/connect/dist "@tsparticles/interaction-external-grab": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/grab/dist "@tsparticles/interaction-external-parallax": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/parallax/dist "@tsparticles/interaction-external-pause": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/pause/dist "@tsparticles/interaction-external-push": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/push/dist "@tsparticles/interaction-external-remove": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/remove/dist "@tsparticles/interaction-external-repulse": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/repulse/dist "@tsparticles/interaction-external-slow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/slow/dist "@tsparticles/interaction-particles-attract": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/attract/dist "@tsparticles/interaction-particles-collisions": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/collisions/dist "@tsparticles/interaction-particles-links": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/links/dist "@tsparticles/plugin-easing-quad": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quad/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/interactivity/dist "@tsparticles/shape-emoji": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/emoji/dist "@tsparticles/shape-image": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/image/dist "@tsparticles/shape-line": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/line/dist "@tsparticles/shape-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/polygon/dist "@tsparticles/shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/square/dist "@tsparticles/shape-star": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/star/dist "@tsparticles/updater-life": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/life/dist "@tsparticles/updater-rotate": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/rotate/dist "@tsparticles/updater-stroke-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/strokeColor/dist publishDirectory: dist demo/electron: dependencies: "@tsparticles/configs": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/configs/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist tsparticles: - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/full/dist devDependencies: electron: - specifier: ^41.0.2 - version: 41.0.2 + specifier: ^41.0.3 + version: 41.0.3 demo/vanilla: dependencies: "@tsparticles/all": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/all/dist "@tsparticles/basic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/basic/dist "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/canvasUtils/dist "@tsparticles/confetti": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/confetti/dist "@tsparticles/configs": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/configs/dist "@tsparticles/effect-bubble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/bubble/dist "@tsparticles/effect-particles": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/particles/dist "@tsparticles/effect-shadow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/shadow/dist "@tsparticles/effect-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../effects/trail/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/fireworks": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/fireworks/dist "@tsparticles/fractal-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/fractalNoise/dist "@tsparticles/interaction-external-attract": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/attract/dist "@tsparticles/interaction-external-bounce": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/bounce/dist "@tsparticles/interaction-external-bubble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/bubble/dist "@tsparticles/interaction-external-connect": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/connect/dist + "@tsparticles/interaction-external-drag": + specifier: workspace:4.0.0-beta.0 + version: link:../../interactions/external/drag/dist "@tsparticles/interaction-external-grab": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/grab/dist "@tsparticles/interaction-external-parallax": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/parallax/dist "@tsparticles/interaction-external-particle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/particle/dist "@tsparticles/interaction-external-pause": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/pause/dist "@tsparticles/interaction-external-pop": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/pop/dist "@tsparticles/interaction-external-push": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/push/dist "@tsparticles/interaction-external-remove": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/remove/dist "@tsparticles/interaction-external-repulse": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/repulse/dist "@tsparticles/interaction-external-slow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/slow/dist "@tsparticles/interaction-external-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/external/trail/dist "@tsparticles/interaction-light": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/light/dist "@tsparticles/interaction-particles-attract": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/attract/dist "@tsparticles/interaction-particles-collisions": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/collisions/dist "@tsparticles/interaction-particles-links": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/links/dist "@tsparticles/interaction-particles-repulse": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/repulse/dist "@tsparticles/noise-field": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/noiseField/dist "@tsparticles/path-branches": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/branches/dist "@tsparticles/path-brownian": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/brownian/dist "@tsparticles/path-curl-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/curlNoise/dist "@tsparticles/path-curves": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/curves/dist "@tsparticles/path-fractal-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/fractalNoise/dist "@tsparticles/path-grid": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/grid/dist "@tsparticles/path-levy": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/levy/dist "@tsparticles/path-perlin-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/perlinNoise/dist "@tsparticles/path-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/polygon/dist "@tsparticles/path-random": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/random/dist "@tsparticles/path-simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/simplexNoise/dist "@tsparticles/path-spiral": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/spiral/dist "@tsparticles/path-svg": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/svg/dist "@tsparticles/path-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/pathUtils/dist "@tsparticles/path-zig-zag": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/zigzag/dist "@tsparticles/perlin-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/perlinNoise/dist "@tsparticles/pjs": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/pjs/dist "@tsparticles/plugin-absorbers": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/absorbers/dist "@tsparticles/plugin-background-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/backgroundMask/dist "@tsparticles/plugin-blend": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/blend/dist "@tsparticles/plugin-canvas-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/canvasMask/dist "@tsparticles/plugin-easing-back": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/back/dist "@tsparticles/plugin-easing-bounce": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/bounce/dist "@tsparticles/plugin-easing-circ": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/circ/dist "@tsparticles/plugin-easing-cubic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/cubic/dist "@tsparticles/plugin-easing-elastic": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/elastic/dist "@tsparticles/plugin-easing-expo": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/expo/dist "@tsparticles/plugin-easing-gaussian": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/gaussian/dist "@tsparticles/plugin-easing-linear": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/linear/dist "@tsparticles/plugin-easing-quad": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quad/dist "@tsparticles/plugin-easing-quart": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quart/dist "@tsparticles/plugin-easing-quint": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/quint/dist "@tsparticles/plugin-easing-sigmoid": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/sigmoid/dist "@tsparticles/plugin-easing-sine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/sine/dist "@tsparticles/plugin-easing-smoothstep": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/easings/smoothstep/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emitters/dist "@tsparticles/plugin-emitters-shape-canvas": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/canvas/dist "@tsparticles/plugin-emitters-shape-circle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/circle/dist "@tsparticles/plugin-emitters-shape-path": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/path/dist "@tsparticles/plugin-emitters-shape-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/polygon/dist "@tsparticles/plugin-emitters-shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/emittersShapes/square/dist "@tsparticles/plugin-export-image": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/image/dist "@tsparticles/plugin-export-json": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/json/dist "@tsparticles/plugin-export-video": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/exports/video/dist "@tsparticles/plugin-hex-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hex/dist "@tsparticles/plugin-hsl-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsl/dist "@tsparticles/plugin-hsv-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsv/dist "@tsparticles/plugin-hwb-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hwb/dist "@tsparticles/plugin-infection": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/infection/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/interactivity/dist "@tsparticles/plugin-lab-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/lab/dist "@tsparticles/plugin-lch-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/lch/dist "@tsparticles/plugin-manual-particles": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/manualParticles/dist "@tsparticles/plugin-motion": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/motion/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist "@tsparticles/plugin-named-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/named/dist "@tsparticles/plugin-oklab-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/oklab/dist "@tsparticles/plugin-oklch-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/oklch/dist "@tsparticles/plugin-poisson-disc": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/poisson/dist "@tsparticles/plugin-polygon-mask": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/polygonMask/dist "@tsparticles/plugin-responsive": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/responsive/dist "@tsparticles/plugin-rgb-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/rgb/dist "@tsparticles/plugin-sounds": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/sounds/dist "@tsparticles/plugin-themes": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/themes/dist "@tsparticles/plugin-trail": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/trail/dist "@tsparticles/plugin-zoom": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/zoom/dist "@tsparticles/shape-arrow": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/arrow/dist "@tsparticles/shape-cards": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/cards/dist "@tsparticles/shape-circle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/circle/dist "@tsparticles/shape-cog": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/cog/dist "@tsparticles/shape-emoji": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/emoji/dist "@tsparticles/shape-heart": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/heart/dist "@tsparticles/shape-image": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/image/dist "@tsparticles/shape-infinity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/infinity/dist "@tsparticles/shape-line": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/line/dist "@tsparticles/shape-matrix": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/matrix/dist "@tsparticles/shape-path": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/path/dist "@tsparticles/shape-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/polygon/dist "@tsparticles/shape-rounded-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/rounded-polygon/dist "@tsparticles/shape-rounded-rect": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/rounded-rect/dist "@tsparticles/shape-spiral": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/spiral/dist "@tsparticles/shape-square": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/square/dist "@tsparticles/shape-squircle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/squircle/dist "@tsparticles/shape-star": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/star/dist "@tsparticles/shape-text": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../shapes/text/dist "@tsparticles/simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/simplexNoise/dist "@tsparticles/slim": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/slim/dist "@tsparticles/smooth-value-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/smoothValueNoise/dist "@tsparticles/updater-destroy": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/destroy/dist "@tsparticles/updater-fill-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/fillColor/dist "@tsparticles/updater-gradient": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/gradient/dist "@tsparticles/updater-life": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/life/dist "@tsparticles/updater-opacity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/opacity/dist "@tsparticles/updater-orbit": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/orbit/dist "@tsparticles/updater-out-modes": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/outModes/dist "@tsparticles/updater-roll": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/roll/dist "@tsparticles/updater-rotate": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/rotate/dist "@tsparticles/updater-size": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/size/dist "@tsparticles/updater-stroke-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/strokeColor/dist "@tsparticles/updater-tilt": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/tilt/dist "@tsparticles/updater-twinkle": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/twinkle/dist "@tsparticles/updater-wobble": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/wobble/dist tsparticles: - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/full/dist devDependencies: "@datalust/winston-seq": @@ -1104,8 +1110,8 @@ importers: specifier: ^0.9.5 version: 0.9.5 "@types/node": - specifier: ^25.4.0 - version: 25.4.0 + specifier: ^25.5.0 + version: 25.5.0 "@types/stylus": specifier: ^0.48.43 version: 0.48.43 @@ -1149,8 +1155,8 @@ importers: specifier: ^3.1.14 version: 3.1.14 pug: - specifier: ^3.0.3 - version: 3.0.3 + specifier: ^3.0.4 + version: 3.0.4 stats.ts: specifier: ^2.1.6 version: 2.1.6 @@ -1164,40 +1170,40 @@ importers: demo/vanilla_new: dependencies: "@tsparticles/configs": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/configs/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/interaction-light": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/light/dist "@tsparticles/interaction-particles-repulse": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../interactions/particles/repulse/dist "@tsparticles/path-curves": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/curves/dist "@tsparticles/path-perlin-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/perlinNoise/dist "@tsparticles/path-polygon": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/polygon/dist "@tsparticles/path-simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../paths/simplexNoise/dist "@tsparticles/plugin-infection": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/infection/dist "@tsparticles/updater-gradient": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/gradient/dist "@tsparticles/updater-orbit": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../updaters/orbit/dist tsparticles: - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/full/dist devDependencies: "@swc/core": @@ -1216,47 +1222,47 @@ importers: demo/vite: dependencies: "@tsparticles/all": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../bundles/all/dist "@tsparticles/configs": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/configs/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist devDependencies: typescript: specifier: ^5.9.3 version: 5.9.3 vite: - specifier: ^8.0.0 - version: 8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) + specifier: ^7.3.1 + version: 7.3.1(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) effects/bubble: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist effects/particles: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist effects/shadow: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist effects/trail: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist @@ -1266,1014 +1272,1024 @@ importers: interactions/external/attract: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/bounce: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/bubble: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/connect: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 + version: link:../../../engine/dist + "@tsparticles/plugin-interactivity": + specifier: workspace:4.0.0-beta.0 + version: link:../../../plugins/interactivity/dist + publishDirectory: dist + + interactions/external/drag: + dependencies: + "@tsparticles/engine": + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/grab: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/parallax: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/particle: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/pause: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/pop: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/push: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/remove: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/repulse: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/slow: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/external/trail: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/light: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/interactivity/dist publishDirectory: dist interactions/particles/attract: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/particles/collisions: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/particles/links: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist interactions/particles/repulse: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../plugins/interactivity/dist publishDirectory: dist paths/branches: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/brownian: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/curlNoise: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist "@tsparticles/simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/simplexNoise/dist publishDirectory: dist paths/curves: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/fractalNoise: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/fractal-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/fractalNoise/dist "@tsparticles/noise-field": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/noiseField/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/grid: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/levy: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/perlinNoise: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/noise-field": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/noiseField/dist "@tsparticles/perlin-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/perlinNoise/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/polygon: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/random: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/simplexNoise: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/noise-field": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/noiseField/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist "@tsparticles/simplex-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/simplexNoise/dist publishDirectory: dist paths/spiral: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/svg: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist paths/zigzag: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist plugins/absorbers: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../interactivity/dist publishDirectory: dist plugins/backgroundMask: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/blend: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/canvasMask: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/colors/hex: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/hsl: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/hsv: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/hwb: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/lab: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/lch: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/named: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/oklab: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/oklch: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/colors/rgb: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/back: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/bounce: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/circ: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/cubic: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/elastic: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/expo: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/gaussian: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/linear: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/quad: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/quart: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/quint: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/sigmoid: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/sine: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/easings/smoothstep: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/emitters: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../interactivity/dist publishDirectory: dist plugins/emittersShapes/canvas: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../emitters/dist publishDirectory: dist plugins/emittersShapes/circle: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../emitters/dist publishDirectory: dist plugins/emittersShapes/path: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../emitters/dist publishDirectory: dist plugins/emittersShapes/polygon: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../emitters/dist publishDirectory: dist plugins/emittersShapes/square: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist "@tsparticles/plugin-emitters": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../emitters/dist publishDirectory: dist plugins/exports/image: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/exports/json: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/exports/video: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../../engine/dist publishDirectory: dist plugins/infection: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-interactivity": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../interactivity/dist publishDirectory: dist plugins/interactivity: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/manualParticles: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/motion: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/move: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/poisson: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/polygonMask: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/responsive: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/sounds: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/themes: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/trail: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist plugins/zoom: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/arrow: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/cards: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/path-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/pathUtils/dist publishDirectory: dist shapes/circle: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/cog: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/emoji: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/heart: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/image: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/infinity: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/line: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/matrix: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/path: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/path-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/pathUtils/dist publishDirectory: dist shapes/polygon: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/rounded-polygon: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/rounded-rect: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/spiral: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/square: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/squircle: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/star: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist shapes/text: dependencies: "@tsparticles/canvas-utils": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../utils/canvasUtils/dist "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/destroy: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/fillColor: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/gradient: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/life: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/opacity: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/orbit: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/outModes: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/roll: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/rotate: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/size: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/strokeColor: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/tilt: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/twinkle: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist updaters/wobble: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist utils/canvasUtils: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist utils/configs: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist utils/fractalNoise: dependencies: "@tsparticles/smooth-value-noise": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../smoothValueNoise/dist publishDirectory: dist utils/noiseField: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-move": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/move/dist publishDirectory: dist utils/pathUtils: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist publishDirectory: dist @@ -2289,19 +2305,19 @@ importers: utils/tests: dependencies: "@tsparticles/engine": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../engine/dist "@tsparticles/plugin-hex-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hex/dist "@tsparticles/plugin-hsl-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsl/dist "@tsparticles/plugin-hsv-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/hsv/dist "@tsparticles/plugin-rgb-color": - specifier: workspace:4.0.0-alpha.28 + specifier: workspace:4.0.0-beta.0 version: link:../../plugins/colors/rgb/dist packages: @@ -2310,21 +2326,19 @@ packages: { integrity: sha512-1Yjs2SvM8TflER/OD3cOjhWWOZb58A2t7wpE2S9XfBYTiIl+XFhQG2bjy4Pu1I+EAlCNUzRDYDdFwFYUKvXcIA== } engines: { node: ">=0.10.0" } - "@acemir/cssom@0.9.31": - resolution: - { integrity: sha512-ZnR3GSaH+/vJ0YlHau21FjfLYjMpYVIzTD8M8vIEQvIGxeOXyXdzCI140rrCY862p/C/BbzWsjc1dgnM9mkoTA== } - "@adobe/css-tools@4.3.3": resolution: { integrity: sha512-rE0Pygv0sEZ4vBWHlAgJLGDU7Pm8xoO6p3wsEceb7GYAjScrOHpEo8KK/eVkAcnSM+slAEtXjA2JpdjLp4fJQQ== } - "@asamuzakjp/css-color@4.1.2": + "@asamuzakjp/css-color@5.0.1": resolution: - { integrity: sha512-NfBUvBaYgKIuq6E/RBLY1m0IohzNHAYyaJGuTK79Z23uNwmz2jl1mPsC5ZxCCxylinKhT1Amn5oNTlx1wN8cQg== } + { integrity: sha512-2SZFvqMyvboVV1d15lMf7XiI3m7SDqXUuKaTymJYLN6dSGadqp+fVojqJlVoMlbZnlTmu3S0TLwLTJpvBMO1Aw== } + engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } - "@asamuzakjp/dom-selector@6.8.1": + "@asamuzakjp/dom-selector@7.0.3": resolution: - { integrity: sha512-MvRz1nCqW0fsy8Qz4dnLIvhOlMzqDVBabZx6lH+YywFDdjXhMY37SmpV1XFX3JzG5GWHn63j6HX6QPr3lZXHvQ== } + { integrity: sha512-Q6mU0Z6bfj6YvnX2k9n0JxiIwrCFN59x/nWmYQnAqP000ruX/yV+5bp/GRcF5T8ncvfwJQ7fgfP74DlpKExILA== } + engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } "@asamuzakjp/nwsapi@2.3.9": resolution: @@ -2360,23 +2374,12 @@ packages: { integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q== } engines: { node: ">=6.9.0" } - "@babel/parser@7.28.6": - resolution: - { integrity: sha512-TeR9zWR18BvbfPmGbLampPMW+uW1NZnJlRuuHso8i87QZNq2JRF9i6RgxRqtEq+wQGsS19NNTWr2duhnE49mfQ== } - engines: { node: ">=6.0.0" } - hasBin: true - "@babel/parser@7.29.0": resolution: { integrity: sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww== } engines: { node: ">=6.0.0" } hasBin: true - "@babel/types@7.28.6": - resolution: - { integrity: sha512-0ZrskXVEHSWIqZM/sQZ4EV3jZJXRkio/WCxaqKZP1g//CEWEPSfeZFcms4XeKBCHU0ZKnIkdJeU/kF+eRp5lBg== } - engines: { node: ">=6.9.0" } - "@babel/types@7.29.0": resolution: { integrity: sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A== } @@ -2397,25 +2400,25 @@ packages: { integrity: sha512-Ir+AOibqzrIsL6ajt3Rz3LskB7OiMVHqltZmspbW/TJuTVuyOMirVqAkjfY6JISiLHgyNqicAC8AyHHGzNd/dA== } engines: { node: ">=0.1.90" } - "@commitlint/cli@20.4.4": + "@commitlint/cli@20.5.0": resolution: - { integrity: sha512-GLMNQHYGcn0ohL2HMlAnXcD1PS2vqBBGbYKlhrRPOYsWiRoLWtrewsR3uKRb9v/IdS+qOS0vqJQ64n1g8VPKFw== } + { integrity: sha512-yNkyN/tuKTJS3wdVfsZ2tXDM4G4Gi7z+jW54Cki8N8tZqwKBltbIvUUrSbT4hz1bhW/h0CdR+5sCSpXD+wMKaQ== } engines: { node: ">=v18" } hasBin: true - "@commitlint/config-conventional@20.4.4": + "@commitlint/config-conventional@20.5.0": resolution: - { integrity: sha512-Usg+XXbPNG2GtFWTgRURNWCge1iH1y6jQIvvklOdAbyn2t8ajfVwZCnf5t5X4gUsy17BOiY+myszGsSMIvhOVA== } + { integrity: sha512-t3Ni88rFw1XMa4nZHgOKJ8fIAT9M2j5TnKyTqJzsxea7FUetlNdYFus9dz+MhIRZmc16P0PPyEfh6X2d/qw8SA== } engines: { node: ">=v18" } - "@commitlint/config-validator@20.4.4": + "@commitlint/config-validator@20.5.0": resolution: - { integrity: sha512-K8hMS9PTLl7EYe5vWtSFQ/sgsV2PHUOtEnosg8k3ZQxCyfKD34I4C7FxWEfRTR54rFKeUYmM3pmRQqBNQeLdlw== } + { integrity: sha512-T/Uh6iJUzyx7j35GmHWdIiGRQB+ouZDk0pwAaYq4SXgB54KZhFdJ0vYmxiW6AMYICTIWuyMxDBl1jK74oFp/Gw== } engines: { node: ">=v18" } - "@commitlint/ensure@20.4.4": + "@commitlint/ensure@20.5.0": resolution: - { integrity: sha512-QivV0M1MGL867XCaF+jJkbVXEPKBALhUUXdjae66hes95aY1p3vBJdrcl3x8jDv2pdKWvIYIz+7DFRV/v0dRkA== } + { integrity: sha512-IpHqAUesBeW1EDDdjzJeaOxU9tnogLAyXLRBn03SHlj1SGENn2JGZqSWGkFvBJkJzfXAuCNtsoYzax+ZPS+puw== } engines: { node: ">=v18" } "@commitlint/execute-rule@20.0.0": @@ -2423,24 +2426,24 @@ packages: { integrity: sha512-xyCoOShoPuPL44gVa+5EdZsBVao/pNzpQhkzq3RdtlFdKZtjWcLlUFQHSWBuhk5utKYykeJPSz2i8ABHQA+ZZw== } engines: { node: ">=v18" } - "@commitlint/format@20.4.4": + "@commitlint/format@20.5.0": resolution: - { integrity: sha512-jLi/JBA4GEQxc5135VYCnkShcm1/rarbXMn2Tlt3Si7DHiiNKHm4TaiJCLnGbZ1r8UfwDRk+qrzZ80kwh08Aow== } + { integrity: sha512-TI9EwFU/qZWSK7a5qyXMpKPPv3qta7FO4tKW+Wt2al7sgMbLWTsAcDpX1cU8k16TRdsiiet9aOw0zpvRXNJu7Q== } engines: { node: ">=v18" } - "@commitlint/is-ignored@20.4.4": + "@commitlint/is-ignored@20.5.0": resolution: - { integrity: sha512-y76rT8yq02x+pMDBI2vY4y/ByAwmJTkta/pASbgo8tldBiKLduX8/2NCRTSCjb3SumE5FBeopERKx3oMIm8RTQ== } + { integrity: sha512-JWLarAsurHJhPozbuAH6GbP4p/hdOCoqS9zJMfqwswne+/GPs5V0+rrsfOkP68Y8PSLphwtFXV0EzJ+GTXTTGg== } engines: { node: ">=v18" } - "@commitlint/lint@20.4.4": + "@commitlint/lint@20.5.0": resolution: - { integrity: sha512-svOEW+RptcNpXKE7UllcAsV0HDIdOck9reC2TP1QA6K5Fo0xxQV+QPjV8Zqx9g6X/hQBkF2S9ZQZ78Xrv1Eiog== } + { integrity: sha512-jiM3hNUdu04jFBf1VgPdjtIPvbuVfDTBAc6L98AWcoLjF5sYqkulBHBzlVWll4rMF1T5zeQFB6r//a+s+BBKlA== } engines: { node: ">=v18" } - "@commitlint/load@20.4.4": + "@commitlint/load@20.5.0": resolution: - { integrity: sha512-kvFrzvoIACa/fMjXEP0LNEJB1joaH3q3oeMJsLajXE5IXjYrNGVcW1ZFojXUruVJ7odTZbC3LdE/6+ONW4f2Dg== } + { integrity: sha512-sLhhYTL/KxeOTZjjabKDhwidGZan84XKK1+XFkwDYL/4883kIajcz/dZFAhBJmZPtL8+nBx6bnkzA95YxPeDPw== } engines: { node: ">=v18" } "@commitlint/message@20.4.3": @@ -2448,24 +2451,24 @@ packages: { integrity: sha512-6akwCYrzcrFcTYz9GyUaWlhisY4lmQ3KvrnabmhoeAV8nRH4dXJAh4+EUQ3uArtxxKQkvxJS78hNX2EU3USgxQ== } engines: { node: ">=v18" } - "@commitlint/parse@20.4.4": + "@commitlint/parse@20.5.0": resolution: - { integrity: sha512-AjfgOgrjEozeQNzhFu1KL5N0nDx4JZmswVJKNfOTLTUGp6xODhZHCHqb//QUHKOzx36If5DQ7tci2o7szYxu1A== } + { integrity: sha512-SeKWHBMk7YOTnnEWUhx+d1a9vHsjjuo6Uo1xRfPNfeY4bdYFasCH1dDpAv13Lyn+dDPOels+jP6D2GRZqzc5fA== } engines: { node: ">=v18" } - "@commitlint/read@20.4.4": + "@commitlint/read@20.5.0": resolution: - { integrity: sha512-jvgdAQDdEY6L8kCxOo21IWoiAyNFzvrZb121wU2eBxI1DzWAUZgAq+a8LlJRbT0Qsj9INhIPVWgdaBbEzlF0dQ== } + { integrity: sha512-JDEIJ2+GnWpK8QqwfmW7O42h0aycJEWNqcdkJnyzLD11nf9dW2dWLTVEa8Wtlo4IZFGLPATjR5neA5QlOvIH1w== } engines: { node: ">=v18" } - "@commitlint/resolve-extends@20.4.4": + "@commitlint/resolve-extends@20.5.0": resolution: - { integrity: sha512-pyOf+yX3c3m/IWAn2Jop+7s0YGKPQ8YvQaxt9IQxnLIM3yZAlBdkKiQCT14TnrmZTkVGTXiLtckcnFTXYwlY0A== } + { integrity: sha512-3SHPWUW2v0tyspCTcfSsYml0gses92l6TlogwzvM2cbxDgmhSRc+fldDjvGkCXJrjSM87BBaWYTPWwwyASZRrg== } engines: { node: ">=v18" } - "@commitlint/rules@20.4.4": + "@commitlint/rules@20.5.0": resolution: - { integrity: sha512-PmUp8QPLICn9w05dAx5r1rdOYoTk7SkfusJJh5tP3TqHwo2mlQ9jsOm8F0HSXU9kuLfgTEGNrunAx/dlK/RyPQ== } + { integrity: sha512-5NdQXQEdnDPT5pK8O39ZA7HohzPRHEsDGU23cyVCNPQy4WegAbAwrQk3nIu7p2sl3dutPk8RZd91yKTrMTnRkQ== } engines: { node: ">=v18" } "@commitlint/to-lines@20.0.0": @@ -2478,9 +2481,9 @@ packages: { integrity: sha512-qD9xfP6dFg5jQ3NMrOhG0/w5y3bBUsVGyJvXxdWEwBm8hyx4WOk3kKXw28T5czBYvyeCVJgJJ6aoJZUWDpaacQ== } engines: { node: ">=v18" } - "@commitlint/types@20.4.4": + "@commitlint/types@20.5.0": resolution: - { integrity: sha512-dwTGzyAblFXHJNBOgrTuO5Ee48ioXpS5XPRLLatxhQu149DFAHUcB3f0Q5eea3RM4USSsP1+WVT2dBtLVod4fg== } + { integrity: sha512-ZJoS8oSq2CAZEpc/YI9SulLrdiIyXeHb/OGqGrkUP6Q7YV+0ouNAa7GjqRdXeQPncHQIDz/jbCTlHScvYvO/gA== } engines: { node: ">=v18" } "@conventional-changelog/git-client@2.6.0": @@ -2501,9 +2504,9 @@ packages: { integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw== } engines: { node: ">=12" } - "@csstools/color-helpers@6.0.1": + "@csstools/color-helpers@6.0.2": resolution: - { integrity: sha512-NmXRccUJMk2AWA5A7e5a//3bCIMyOu2hAtdRYrhPPHjDxINuCwX1w6rnIZ4xjLcp0ayv6h8Pc3X0eJUGiAAXHQ== } + { integrity: sha512-LMGQLS9EuADloEFkcTBR3BwV/CGHV7zyDxVRtVDTwdI2Ca4it0CCVTT9wCkxSgokjE5Ho41hEPgb8OEUwoXr6Q== } engines: { node: ">=20.19.0" } "@csstools/css-calc@3.1.1": @@ -2514,9 +2517,9 @@ packages: "@csstools/css-parser-algorithms": ^4.0.0 "@csstools/css-tokenizer": ^4.0.0 - "@csstools/css-color-parser@4.0.1": + "@csstools/css-color-parser@4.0.2": resolution: - { integrity: sha512-vYwO15eRBEkeF6xjAno/KQ61HacNhfQuuU/eGwH67DplL0zD5ZixUa563phQvUelA07yDczIXdtmYojCphKJcw== } + { integrity: sha512-0GEfbBLmTFf0dJlpsNU7zwxRIH0/BGEMuXLTCvFYxuL1tNhqzTbtnFICyJLTNK4a+RechKP75e7w42ClXSnJQw== } engines: { node: ">=20.19.0" } peerDependencies: "@csstools/css-parser-algorithms": ^4.0.0 @@ -2529,9 +2532,14 @@ packages: peerDependencies: "@csstools/css-tokenizer": ^4.0.0 - "@csstools/css-syntax-patches-for-csstree@1.0.27": + "@csstools/css-syntax-patches-for-csstree@1.1.1": resolution: - { integrity: sha512-sxP33Jwg1bviSUXAV43cVYdmjt2TLnLXNqCWl9xmxHawWVjGz/kEbdkr7F9pxJNBN2Mh+dq0crgItbW6tQvyow== } + { integrity: sha512-BvqN0AMWNAnLk9G8jnUT77D+mUbY/H2b3uDTvg2isJkHaOufUE2R3AOwxWo7VBQKT1lOdwdvorddo2B/lk64+w== } + peerDependencies: + css-tree: ^3.2.1 + peerDependenciesMeta: + css-tree: + optional: true "@csstools/css-tokenizer@4.0.0": resolution: @@ -2558,9 +2566,9 @@ packages: { integrity: sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw== } engines: { node: ">=10.0.0" } - "@discoveryjs/json-ext@0.6.3": + "@discoveryjs/json-ext@1.0.0": resolution: - { integrity: sha512-4B4OijXeVNOPZlYA2oEwWOTkzyltLao+xbotHQeqN++Rv27Y6s818+n2Qkp8q+Fxhn0t/5lA5X1Mxktud8eayQ== } + { integrity: sha512-dDlz3W405VMFO4w5kIP9DOmELBcvFQGmLoKSdIRstBDubKFYwaNHV1NnlzMCQpXQFGWVALmeMORAuiLx18AvZQ== } engines: { node: ">=14.17.0" } "@electron/get@2.0.3": @@ -2568,26 +2576,14 @@ packages: { integrity: sha512-Qkzpg2s9GnVV2I2BjRksUi43U5e6+zaQMcjoJy0C+C5oxaKl+fmckGDQFtRpZpZV0NQekuZZ+tGz7EA9TVnQtQ== } engines: { node: ">=12" } - "@emnapi/core@1.2.0": - resolution: - { integrity: sha512-E7Vgw78I93we4ZWdYCb4DGAwRROGkMIXk7/y87UmANR+J6qsWusmC3gLt0H+O0KOt5e6O38U8oJamgbudrES/w== } - "@emnapi/core@1.8.1": resolution: { integrity: sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg== } - "@emnapi/runtime@1.2.0": - resolution: - { integrity: sha512-bV21/9LQmcQeCPEg3BDFtvwL6cwiTMksYNWQQ4KOxCZikEGalWtenoZ0wCiukJINlGCIi2KXx01g4FoH/LxpzQ== } - "@emnapi/runtime@1.8.1": resolution: { integrity: sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg== } - "@emnapi/wasi-threads@1.0.1": - resolution: - { integrity: sha512-iIBu7mwkq4UQGeMEM8bLwNK962nXdhodeScX4slfQnRhEMMzvYivHhutCIk8uojvmASXXPC2WNEjwxFWk72Oqw== } - "@emnapi/wasi-threads@1.1.0": resolution: { integrity: sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ== } @@ -2835,9 +2831,9 @@ packages: { integrity: sha512-iH1B076HoAshH1mLpHMgwdGeTs0CYwL0SPMkGuSebZrwBp16v415e9NZXg2jtrqPVQjf6IANe2Vtlr5KswtcZQ== } engines: { node: ^20.19.0 || ^22.13.0 || >=24 } - "@exodus/bytes@1.11.0": + "@exodus/bytes@1.15.0": resolution: - { integrity: sha512-wO3vd8nsEHdumsXrjGO/v4p6irbg7hy9kvIeR6i2AwylZSk4HJdWgL0FNaVquW1+AweJcdvU1IEpuIWk/WaPnA== } + { integrity: sha512-UY0nlA+feH81UGSHv92sLEPLCeZFjXOuHhrIo0HQydScuQc8s0A7kL/UdgwgDq8g8ilksmuoF35YVTNphV2aBQ== } engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } peerDependencies: "@noble/hashes": ^1.8.0 || ^2.0.0 @@ -3094,6 +3090,10 @@ packages: resolution: { integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ== } + "@ltd/j-toml@1.38.0": + resolution: + { integrity: sha512-lYtBcmvHustHQtg4X7TXUu1Xa/tbLC3p2wLvgQI+fWVySguVZJF60Snxijw5EiohumxZbR10kWYFFebh1zotiw== } + "@microsoft/tsdoc-config@0.18.1": resolution: { integrity: sha512-9brPoVdfN9k9g0dcWkFeA7IH9bbcttzDJlXvkf8b2OBzd5MueR1V2wkKBL0abn0otvmkHJC6aapBOTJDDeMCZg== } @@ -3238,67 +3238,67 @@ packages: peerDependencies: nx: ">= 21 <= 23 || ^22.0.0-0" - "@nx/nx-darwin-arm64@22.5.4": + "@nx/nx-darwin-arm64@22.6.0": resolution: - { integrity: sha512-Ib9znwSLQZSZ/9hhg5ODplpNhE/RhGVXzdfRj6YonTuWSj/kH3dLMio+4JEkjRdTQVm06cDW0KdwSgnwovqMGg== } + { integrity: sha512-sOlgi3ym6gA5ipMtTv39fC3+33KvNEAsI5CoVejVezLdVFjtSlS+ccR3OKZRZeuZuvpeOzKNqGtnqwE+UNtIhg== } cpu: [arm64] os: [darwin] - "@nx/nx-darwin-x64@22.5.4": + "@nx/nx-darwin-x64@22.6.0": resolution: - { integrity: sha512-DjyXuQMc93MPU2XdRsJYjzbv1tgCzMi+zm7O0gc4x3h+ECFjKkjzQBg67pqGdhE3TV27MAlVRKrgHStyK9iigg== } + { integrity: sha512-qg+wMRkgPazGG3dBKtP8mRFppLTigyGVJJnRfQquxnjXPY5oFVL9UZcKbISItAIdSk5jzxZ9SwAIMk2Ggeg36w== } cpu: [x64] os: [darwin] - "@nx/nx-freebsd-x64@22.5.4": + "@nx/nx-freebsd-x64@22.6.0": resolution: - { integrity: sha512-DhxdP8AhIfN0yCtFhZQcbp32MVN3L7UiTotYqqnOgwW922NRGSd5e+KEAWiJVrIO6TdgnI7prxpg1hfQQK0WDw== } + { integrity: sha512-PjYRBZalFE2IGrZD7ukGXfRppPm21BpeGVqPH6BjcnB8dmyRx5cJG1uc6xom09yQK5X0Z+PPYzQhYGmZn5F4yQ== } cpu: [x64] os: [freebsd] - "@nx/nx-linux-arm-gnueabihf@22.5.4": + "@nx/nx-linux-arm-gnueabihf@22.6.0": resolution: - { integrity: sha512-pv1x1afTaLAOxPxVhQneLeXgjclp11f9ORxR7jA4E86bSgc9OL92dLSCkXtLQzqPNOej6SZ2fO+PPHVMZwtaPQ== } + { integrity: sha512-rb/KEq90/Su5mzPdDybURzHt8cTAqwJPd6K/Q1ojD9dmClYVsPUZjbGwNveeQRp/iD1kzbaUF2WcbJx1b87seg== } cpu: [arm] os: [linux] - "@nx/nx-linux-arm64-gnu@22.5.4": + "@nx/nx-linux-arm64-gnu@22.6.0": resolution: - { integrity: sha512-mPji9PzleWPvXpmFDKaXpTymRgZkk/hW8JHGhvEZpKHHXMYgTGWC+BqOEM2A4dYC4bu4fi9RrteL7aouRRWJoQ== } + { integrity: sha512-AfcY3cbtqwc43pIkI0vlgak70P7cQgt8RhfRpG9rd3LYEpdaVxxfKP+0unMFjT23UWEUfexHlJyLoam1lgIenQ== } cpu: [arm64] os: [linux] libc: [glibc] - "@nx/nx-linux-arm64-musl@22.5.4": + "@nx/nx-linux-arm64-musl@22.6.0": resolution: - { integrity: sha512-hF/HvEhbCjcFpTgY7RbP1tUTbp0M1adZq4ckyW8mwhDWQ/MDsc8FnOHwCO3Bzy9ZeJM0zQUES6/m0Onz8geaEA== } + { integrity: sha512-hvFMdPnS1nSnzyklOJMyQEC12ovC8h0JRAvdmpEKBPLiHV3Wjuj2IGSl0MCMI/YVMq3Y3uxRtwIKqHzYsZK8kw== } cpu: [arm64] os: [linux] libc: [musl] - "@nx/nx-linux-x64-gnu@22.5.4": + "@nx/nx-linux-x64-gnu@22.6.0": resolution: - { integrity: sha512-1+vicSYEOtc7CNMoRCjo59no4gFe8w2nGIT127wk1yeW3EJzRVNlOA7Deu10NUUbzLeOvHc8EFOaU7clT+F7XQ== } + { integrity: sha512-1EM/M9RVVfqSWsSJAb8RLXGBGiVuwLb2AA4Dpv1pC+yjziAbfg9ERsVXuh14XaUTklBugI+Tm/k0dyZD2B22qw== } cpu: [x64] os: [linux] libc: [glibc] - "@nx/nx-linux-x64-musl@22.5.4": + "@nx/nx-linux-x64-musl@22.6.0": resolution: - { integrity: sha512-/KjndxVB14yU0SJOhqADHOWoTy4Y45h5RjW3cxcXlPSJZz7ar1FnlLne1rWMMMUttepc8ku+3T//SGKi2eu+Nw== } + { integrity: sha512-C33hO5YMv55K0XK+elkCUKEN3c/86KAVTpXRGr3Ywvw/5dftR4vYI/yfBUC/gbxW95AjzeX9fHtY1EThKUCvuA== } cpu: [x64] os: [linux] libc: [musl] - "@nx/nx-win32-arm64-msvc@22.5.4": + "@nx/nx-win32-arm64-msvc@22.6.0": resolution: - { integrity: sha512-CrYt9FwhjOI6ZNy/G6YHLJmZuXCFJ24BCxugPXiZ7knDx7eGrr7owGgfht4SSiK3KCX40CvWCBJfqR4ZSgaSUA== } + { integrity: sha512-/NJ1CgAWBpR55PUENospq5sChxK9PC2NIgOI5BLZpyjClAW1dLwaKRr5EFDS4wBKzhz5Dp9ebmo92MiPEWsAvg== } cpu: [arm64] os: [win32] - "@nx/nx-win32-x64-msvc@22.5.4": + "@nx/nx-win32-x64-msvc@22.6.0": resolution: - { integrity: sha512-g5YByv4XsYwsYZvFe24A9bvfhZA+mwtIQt6qZtEVduZTT1hfhIsq0LXGHhkGoFLYwRMXSracWOqkalY0KT4IQw== } + { integrity: sha512-XY/csfuGjVwVFyFayU0ZWbnXPinVnP/AcjMi39SCWM72bxeSB1lKmPYo0z/18mJcGQRQC0mJrGpzr1YPlhW3mQ== } cpu: [x64] os: [win32] @@ -3517,14 +3517,9 @@ packages: cpu: [x64] os: [win32] - "@oxc-project/runtime@0.115.0": + "@oxc-project/types@0.120.0": resolution: - { integrity: sha512-Rg8Wlt5dCbXhQnsXPrkOjL1DTSvXLgb2R/KYfnf1/K+R0k6UMLEmbQXPM+kwrWqSmWA2t0B1EtHy2/3zikQpvQ== } - engines: { node: ^20.19.0 || >=22.12.0 } - - "@oxc-project/types@0.115.0": - resolution: - { integrity: sha512-4n91DKnebUS4yjUHl2g3/b2T+IUdCfmoZGhmwsovZCDaJSs+QkVAM+0AqqTxHSsHfeiMuueT75cZaZcT/m0pSw== } + { integrity: sha512-k1YNu55DuvAip/MGE1FTsIuU3FUCn6v/ujG9V7Nq5Df/kX2CWb13hhwD0lmJGMGqE+bE1MXvv9SZVnMzEXlWcg== } "@parcel/watcher-android-arm64@2.5.1": resolution: @@ -3651,119 +3646,282 @@ packages: { integrity: sha512-v/nzJzgUyh9TzRfy+5pTjj1z8Yhhg83TC4TQ/Mrrn2UwJnWWS/mVcpOWwHuFy7KsLnazE0ChHK/anM7GncrbHg== } engines: { node: ">=22" } - "@rolldown/binding-android-arm64@1.0.0-rc.9": + "@rolldown/binding-android-arm64@1.0.0-rc.10": resolution: - { integrity: sha512-lcJL0bN5hpgJfSIz/8PIf02irmyL43P+j1pTCfbD1DbLkmGRuFIA4DD3B3ZOvGqG0XiVvRznbKtN0COQVaKUTg== } + { integrity: sha512-jOHxwXhxmFKuXztiu1ORieJeTbx5vrTkcOkkkn2d35726+iwhrY1w/+nYY/AGgF12thg33qC3R1LMBF5tHTZHg== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [android] - "@rolldown/binding-darwin-arm64@1.0.0-rc.9": + "@rolldown/binding-darwin-arm64@1.0.0-rc.10": resolution: - { integrity: sha512-J7Zk3kLYFsLtuH6U+F4pS2sYVzac0qkjcO5QxHS7OS7yZu2LRs+IXo+uvJ/mvpyUljDJ3LROZPoQfgBIpCMhdQ== } + { integrity: sha512-gED05Teg/vtTZbIJBc4VNMAxAFDUPkuO/rAIyyxZjTj1a1/s6z5TII/5yMGZ0uLRCifEtwUQn8OlYzuYc0m70w== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [darwin] - "@rolldown/binding-darwin-x64@1.0.0-rc.9": + "@rolldown/binding-darwin-x64@1.0.0-rc.10": resolution: - { integrity: sha512-iwtmmghy8nhfRGeNAIltcNXzD0QMNaaA5U/NyZc1Ia4bxrzFByNMDoppoC+hl7cDiUq5/1CnFthpT9n+UtfFyg== } + { integrity: sha512-rI15NcM1mA48lqrIxVkHfAqcyFLcQwyXWThy+BQ5+mkKKPvSO26ir+ZDp36AgYoYVkqvMcdS8zOE6SeBsR9e8A== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [x64] os: [darwin] - "@rolldown/binding-freebsd-x64@1.0.0-rc.9": + "@rolldown/binding-freebsd-x64@1.0.0-rc.10": resolution: - { integrity: sha512-DLFYI78SCiZr5VvdEplsVC2Vx53lnA4/Ga5C65iyldMVaErr86aiqCoNBLl92PXPfDtUYjUh+xFFor40ueNs4Q== } + { integrity: sha512-XZRXHdTa+4ME1MuDVp021+doQ+z6Ei4CCFmNc5/sKbqb8YmkiJdj8QKlV3rCI0AJtAeSB5n0WGPuJWNL9p/L2w== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [x64] os: [freebsd] - "@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.9": + "@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.10": resolution: - { integrity: sha512-CsjTmTwd0Hri6iTw/DRMK7kOZ7FwAkrO4h8YWKoX/kcj833e4coqo2wzIFywtch/8Eb5enQ/lwLM7w6JX1W5RQ== } + { integrity: sha512-R0SQMRluISSLzFE20sPWYHVmJdDQnRyc/FzSCN72BqQmh2SOZUFG+N3/vBZpR4C6WpEUVYJLrYUXaj43sJsNLA== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm] os: [linux] - "@rolldown/binding-linux-arm64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-arm64-gnu@1.0.0-rc.10": resolution: - { integrity: sha512-2x9O2JbSPxpxMDhP9Z74mahAStibTlrBMW0520+epJH5sac7/LwZW5Bmg/E6CXuEF53JJFW509uP+lSedaUNxg== } + { integrity: sha512-Y1reMrV/o+cwpduYhJuOE3OMKx32RMYCidf14y+HssARRmhDuWXJ4yVguDg2R/8SyyGNo+auzz64LnPK9Hq6jg== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [linux] libc: [glibc] - "@rolldown/binding-linux-arm64-musl@1.0.0-rc.9": + "@rolldown/binding-linux-arm64-musl@1.0.0-rc.10": resolution: - { integrity: sha512-JA1QRW31ogheAIRhIg9tjMfsYbglXXYGNPLdPEYrwFxdbkQCAzvpSCSHCDWNl4hTtrol8WeboCSEpjdZK8qrCg== } + { integrity: sha512-vELN+HNb2IzuzSBUOD4NHmP9yrGwl1DVM29wlQvx1OLSclL0NgVWnVDKl/8tEks79EFek/kebQKnNJkIAA4W2g== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [linux] libc: [musl] - "@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.10": resolution: - { integrity: sha512-aOKU9dJheda8Kj8Y3w9gnt9QFOO+qKPAl8SWd7JPHP+Cu0EuDAE5wokQubLzIDQWg2myXq2XhTpOVS07qqvT+w== } + { integrity: sha512-ZqrufYTgzxbHwpqOjzSsb0UV/aV2TFIY5rP8HdsiPTv/CuAgCRjM6s9cYFwQ4CNH+hf9Y4erHW1GjZuZ7WoI7w== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [ppc64] os: [linux] libc: [glibc] - "@rolldown/binding-linux-s390x-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-s390x-gnu@1.0.0-rc.10": resolution: - { integrity: sha512-OalO94fqj7IWRn3VdXWty75jC5dk4C197AWEuMhIpvVv2lw9fiPhud0+bW2ctCxb3YoBZor71QHbY+9/WToadA== } + { integrity: sha512-gSlmVS1FZJSRicA6IyjoRoKAFK7IIHBs7xJuHRSmjImqk3mPPWbR7RhbnfH2G6bcmMEllCt2vQ/7u9e6bBnByg== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [s390x] os: [linux] libc: [glibc] - "@rolldown/binding-linux-x64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-x64-gnu@1.0.0-rc.10": resolution: - { integrity: sha512-cVEl1vZtBsBZna3YMjGXNvnYYrOJ7RzuWvZU0ffvJUexWkukMaDuGhUXn0rjnV0ptzGVkvc+vW9Yqy6h8YX4pg== } + { integrity: sha512-eOCKUpluKgfObT2pHjztnaWEIbUabWzk3qPZ5PuacuPmr4+JtQG4k2vGTY0H15edaTnicgU428XW/IH6AimcQw== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [x64] os: [linux] libc: [glibc] - "@rolldown/binding-linux-x64-musl@1.0.0-rc.9": + "@rolldown/binding-linux-x64-musl@1.0.0-rc.10": resolution: - { integrity: sha512-UzYnKCIIc4heAKgI4PZ3dfBGUZefGCJ1TPDuLHoCzgrMYPb5Rv6TLFuYtyM4rWyHM7hymNdsg5ik2C+UD9VDbA== } + { integrity: sha512-Xdf2jQbfQowJnLcgYfD/m0Uu0Qj5OdxKallD78/IPPfzaiaI4KRAwZzHcKQ4ig1gtg1SuzC7jovNiM2TzQsBXA== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [x64] os: [linux] libc: [musl] - "@rolldown/binding-openharmony-arm64@1.0.0-rc.9": + "@rolldown/binding-openharmony-arm64@1.0.0-rc.10": resolution: - { integrity: sha512-+6zoiF+RRyf5cdlFQP7nm58mq7+/2PFaY2DNQeD4B87N36JzfF/l9mdBkkmTvSYcYPE8tMh/o3cRlsx1ldLfog== } + { integrity: sha512-o1hYe8hLi1EY6jgPFyxQgQ1wcycX+qz8eEbVmot2hFkgUzPxy9+kF0u0NIQBeDq+Mko47AkaFFaChcvZa9UX9Q== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [openharmony] - "@rolldown/binding-wasm32-wasi@1.0.0-rc.9": + "@rolldown/binding-wasm32-wasi@1.0.0-rc.10": resolution: - { integrity: sha512-rgFN6sA/dyebil3YTlL2evvi/M+ivhfnyxec7AccTpRPccno/rPoNlqybEZQBkcbZu8Hy+eqNJCqfBR8P7Pg8g== } + { integrity: sha512-Ugv9o7qYJudqQO5Y5y2N2SOo6S4WiqiNOpuQyoPInnhVzCY+wi/GHltcLHypG9DEUYMB0iTB/huJrpadiAcNcA== } engines: { node: ">=14.0.0" } cpu: [wasm32] - "@rolldown/binding-win32-arm64-msvc@1.0.0-rc.9": + "@rolldown/binding-win32-arm64-msvc@1.0.0-rc.10": resolution: - { integrity: sha512-lHVNUG/8nlF1IQk1C0Ci574qKYyty2goMiPlRqkC5R+3LkXDkL5Dhx8ytbxq35m+pkHVIvIxviD+TWLdfeuadA== } + { integrity: sha512-7UODQb4fQUNT/vmgDZBl3XOBAIOutP5R3O/rkxg0aLfEGQ4opbCgU5vOw/scPe4xOqBwL9fw7/RP1vAMZ6QlAQ== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [arm64] os: [win32] - "@rolldown/binding-win32-x64-msvc@1.0.0-rc.9": + "@rolldown/binding-win32-x64-msvc@1.0.0-rc.10": resolution: - { integrity: sha512-G0oA4+w1iY5AGi5HcDTxWsoxF509hrFIPB2rduV5aDqS9FtDg1CAfa7V34qImbjfhIcA8C+RekocJZA96EarwQ== } + { integrity: sha512-PYxKHMVHOb5NJuDL53vBUl1VwUjymDcYI6rzpIni0C9+9mTiJedvUxSk7/RPp7OOAm3v+EjgMu9bIy3N6b408w== } engines: { node: ^20.19.0 || >=22.12.0 } cpu: [x64] os: [win32] - "@rolldown/pluginutils@1.0.0-rc.9": + "@rolldown/pluginutils@1.0.0-rc.10": + resolution: + { integrity: sha512-UkVDEFk1w3mveXeKgaTuYfKWtPbvgck1dT8TUG3bnccrH0XtLTuAyfCoks4Q/M5ZGToSVJTIQYCzy2g/atAOeg== } + + "@rollup/rollup-android-arm-eabi@4.59.0": + resolution: + { integrity: sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg== } + cpu: [arm] + os: [android] + + "@rollup/rollup-android-arm64@4.59.0": + resolution: + { integrity: sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q== } + cpu: [arm64] + os: [android] + + "@rollup/rollup-darwin-arm64@4.59.0": + resolution: + { integrity: sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg== } + cpu: [arm64] + os: [darwin] + + "@rollup/rollup-darwin-x64@4.59.0": + resolution: + { integrity: sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w== } + cpu: [x64] + os: [darwin] + + "@rollup/rollup-freebsd-arm64@4.59.0": + resolution: + { integrity: sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA== } + cpu: [arm64] + os: [freebsd] + + "@rollup/rollup-freebsd-x64@4.59.0": + resolution: + { integrity: sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg== } + cpu: [x64] + os: [freebsd] + + "@rollup/rollup-linux-arm-gnueabihf@4.59.0": + resolution: + { integrity: sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw== } + cpu: [arm] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-arm-musleabihf@4.59.0": + resolution: + { integrity: sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA== } + cpu: [arm] + os: [linux] + libc: [musl] + + "@rollup/rollup-linux-arm64-gnu@4.59.0": + resolution: + { integrity: sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA== } + cpu: [arm64] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-arm64-musl@4.59.0": + resolution: + { integrity: sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA== } + cpu: [arm64] + os: [linux] + libc: [musl] + + "@rollup/rollup-linux-loong64-gnu@4.59.0": + resolution: + { integrity: sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg== } + cpu: [loong64] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-loong64-musl@4.59.0": + resolution: + { integrity: sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q== } + cpu: [loong64] + os: [linux] + libc: [musl] + + "@rollup/rollup-linux-ppc64-gnu@4.59.0": + resolution: + { integrity: sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA== } + cpu: [ppc64] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-ppc64-musl@4.59.0": + resolution: + { integrity: sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA== } + cpu: [ppc64] + os: [linux] + libc: [musl] + + "@rollup/rollup-linux-riscv64-gnu@4.59.0": + resolution: + { integrity: sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg== } + cpu: [riscv64] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-riscv64-musl@4.59.0": + resolution: + { integrity: sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg== } + cpu: [riscv64] + os: [linux] + libc: [musl] + + "@rollup/rollup-linux-s390x-gnu@4.59.0": + resolution: + { integrity: sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w== } + cpu: [s390x] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-x64-gnu@4.59.0": + resolution: + { integrity: sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg== } + cpu: [x64] + os: [linux] + libc: [glibc] + + "@rollup/rollup-linux-x64-musl@4.59.0": + resolution: + { integrity: sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg== } + cpu: [x64] + os: [linux] + libc: [musl] + + "@rollup/rollup-openbsd-x64@4.59.0": + resolution: + { integrity: sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ== } + cpu: [x64] + os: [openbsd] + + "@rollup/rollup-openharmony-arm64@4.59.0": + resolution: + { integrity: sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA== } + cpu: [arm64] + os: [openharmony] + + "@rollup/rollup-win32-arm64-msvc@4.59.0": + resolution: + { integrity: sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A== } + cpu: [arm64] + os: [win32] + + "@rollup/rollup-win32-ia32-msvc@4.59.0": + resolution: + { integrity: sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA== } + cpu: [ia32] + os: [win32] + + "@rollup/rollup-win32-x64-gnu@4.59.0": resolution: - { integrity: sha512-w6oiRWgEBl04QkFZgmW+jnU1EC9b57Oihi2ot3HNWIQRqgHp5PnYDia5iZ5FF7rpa4EQdiqMDXjlqKGXBhsoXw== } + { integrity: sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA== } + cpu: [x64] + os: [win32] + + "@rollup/rollup-win32-x64-msvc@4.59.0": + resolution: + { integrity: sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA== } + cpu: [x64] + os: [win32] "@shikijs/engine-oniguruma@3.20.0": resolution: @@ -3971,38 +4129,38 @@ packages: resolution: { integrity: sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA== } - "@tsparticles/cli@3.3.6": + "@tsparticles/cli@3.3.8": resolution: - { integrity: sha512-DvPmkD9wXmpkkyiR/b/XTtcDtvwQSnleYDo6HChl7MOFvuZrDzIfIHEgNGzLFCUXRxS22fAUgNnQEgxFmkSfNg== } + { integrity: sha512-LNOGKvSeD34mTCWr62WCo6kVZqzZmllDH+OMDzCRzz1Dg6RzmJSx1qi1/sdqveIdtRP+YxEZPva6XswUBw3zRw== } hasBin: true - "@tsparticles/depcruise-config@3.3.3": + "@tsparticles/depcruise-config@3.3.5": resolution: - { integrity: sha512-XMWbD/4H4NwpU7dh/9aoE/kJCyp/qd8OA4DTQ1PyW+531axdGMiH2Qam5Y5hrW8lijYSgZEz9CPTECvaHtNgjw== } + { integrity: sha512-Hp/OMURkE521nn9/c8ccYr707zcgMgQ4XRHLvLPPRIQOfri9iRMWuppoXUYD1v/iBBW2JDee7vtjGEST/rLDDg== } peerDependencies: dependency-cruiser: ^17 - "@tsparticles/eslint-config@3.3.3": + "@tsparticles/eslint-config@3.3.5": resolution: - { integrity: sha512-H/rr6TlS415Vu7VurwW6esMAberv92Zy3tMT7yNlObvtP/RSV1kAqHh6Cy0jdg9NjGwLu5UTCxuQs1mZauz9og== } + { integrity: sha512-Uad/9ncxgj/xjg9aX+zuXz91/IivSpWLuIcyrU83qa5RXJE6hFp7kbwQaM2qEqzQBVtyguWBC8ib9PX32+6SIA== } peerDependencies: eslint: ^10 - "@tsparticles/prettier-config@3.3.3": + "@tsparticles/prettier-config@3.3.5": resolution: - { integrity: sha512-YlPaJL/HPkiNZzjRhADjhECFaQ0C3YrIOf/uAqFbaNp3/He9V+mg5pC4wzVRIJLHVLQH6rBNFImRxfva44sTJw== } + { integrity: sha512-YS5Cn8PrsDwXAoJHVC+NLJozKx3el7zfxC0HgIpVe/f8kSlmgatH+p4KJKury2xUCpvhQF2R9cjzbZlTF8PrCQ== } peerDependencies: prettier: ^3 - "@tsparticles/tsconfig@3.3.3": + "@tsparticles/tsconfig@3.3.5": resolution: - { integrity: sha512-n23RmGsi5XVDgytSz+JnoAXhnLIIuDpo78lFdxrRovELKKqAJ1riViSEsRREiTdPYTkJQW1pHOqp4KgoBGNQrw== } + { integrity: sha512-DJ/5FBwyj4MubMDNuRfMyeesAlshtzyMex04NFFyLtTixIVr4h4ZewBwC92YKEyyWvoE2cp7HDB4jkThtxSg+g== } peerDependencies: typescript: ^5 - "@tsparticles/webpack-plugin@3.3.3": + "@tsparticles/webpack-plugin@3.3.5": resolution: - { integrity: sha512-STpNI49H6Y6lKHc9mWXAKZ8atuMFUFvTzt3lszU2RRRGMCQxRHfy++7NQVgg1+vPX0csIdzIANUOyKegZcM6sA== } + { integrity: sha512-Cvw6tdrDIoi7cb4xZaP3z4od3OMQS6xx7CuWMJGEzx9iZUfJUnf/RrLmLxpGpskTCSEW5DbaKpeAKAGETdMYNw== } "@tufjs/canonical-json@2.0.0": resolution: @@ -4106,10 +4264,6 @@ packages: resolution: { integrity: sha512-YATxVxgRqNH6nHEIsvg6k2Boc1JHI9ZbH5iWFFv/MTkchz3b1ieGDa5T0a9RznNdI0KhVbdbWSN+KWWrQZRxTw== } - "@types/minimatch@3.0.5": - resolution: - { integrity: sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ== } - "@types/minimist@1.2.2": resolution: { integrity: sha512-jhuKLIRrhvCPLqwPcx6INqmKeiA5EWrsCOPhrlFSrbrmU4ZMPjj5Ul/oLCMDO98XRUIwVm78xICz4EPCektzeQ== } @@ -4122,10 +4276,6 @@ packages: resolution: { integrity: sha512-ne4A0IpG3+2ETuREInjPNhUGis1SFjv1d5asp8MzEAGtOZeTeHVDOYqOgqfhvseqg/iXty2hjBf1zAOb7RNiNw== } - "@types/node@25.4.0": - resolution: - { integrity: sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw== } - "@types/node@25.5.0": resolution: { integrity: sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw== } @@ -4182,18 +4332,18 @@ packages: resolution: { integrity: sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q== } - "@typescript-eslint/eslint-plugin@8.57.0": + "@typescript-eslint/eslint-plugin@8.57.1": resolution: - { integrity: sha512-qeu4rTHR3/IaFORbD16gmjq9+rEs9fGKdX0kF6BKSfi+gCuG3RCKLlSBYzn/bGsY9Tj7KE/DAQStbp8AHJGHEQ== } + { integrity: sha512-Gn3aqnvNl4NGc6x3/Bqk1AOn0thyTU9bqDRhiRnUWezgvr2OnhYCWCgC8zXXRVqBsIL1pSDt7T9nJUe0oM0kDQ== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: - "@typescript-eslint/parser": ^8.57.0 + "@typescript-eslint/parser": ^8.57.1 eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/parser@8.57.0": + "@typescript-eslint/parser@8.57.1": resolution: - { integrity: sha512-XZzOmihLIr8AD1b9hL9ccNMzEMWt/dE2u7NyTY9jJG6YNiNthaD5XtUHVF2uCXZ15ng+z2hT3MVuxnUYhq6k1g== } + { integrity: sha512-k4eNDan0EIMTT/dUKc/g+rsJ6wcHYhNPdY19VoX/EOtaAG8DLtKCykhrUnuHPYvinn5jhAPgD2Qw9hXBwrahsw== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 @@ -4206,9 +4356,9 @@ packages: peerDependencies: typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/project-service@8.57.0": + "@typescript-eslint/project-service@8.57.1": resolution: - { integrity: sha512-pR+dK0BlxCLxtWfaKQWtYr7MhKmzqZxuii+ZjuFlZlIGRZm22HnXFqa2eY+90MUz8/i80YJmzFGDUsi8dMOV5w== } + { integrity: sha512-vx1F37BRO1OftsYlmG9xay1TqnjNVlqALymwWVuYTdo18XuKxtBpCj1QlzNIEHlvlB27osvXFWptYiEWsVdYsg== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: typescript: ">=4.8.4 <6.0.0" @@ -4218,9 +4368,9 @@ packages: { integrity: sha512-YAi4VDKcIZp0O4tz/haYKhmIDZFEUPOreKbfdAN3SzUDMcPhJ8QI99xQXqX+HoUVq8cs85eRKnD+rne2UAnj2w== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } - "@typescript-eslint/scope-manager@8.57.0": + "@typescript-eslint/scope-manager@8.57.1": resolution: - { integrity: sha512-nvExQqAHF01lUM66MskSaZulpPL5pgy5hI5RfrxviLgzZVffB5yYzw27uK/ft8QnKXI2X0LBrHJFr1TaZtAibw== } + { integrity: sha512-hs/QcpCwlwT2L5S+3fT6gp0PabyGk4Q0Rv2doJXA0435/OpnSR3VRgvrp8Xdoc3UAYSg9cyUjTeFXZEPg/3OKg== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } "@typescript-eslint/tsconfig-utils@8.56.1": @@ -4230,16 +4380,16 @@ packages: peerDependencies: typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/tsconfig-utils@8.57.0": + "@typescript-eslint/tsconfig-utils@8.57.1": resolution: - { integrity: sha512-LtXRihc5ytjJIQEH+xqjB0+YgsV4/tW35XKX3GTZHpWtcC8SPkT/d4tqdf1cKtesryHm2bgp6l555NYcT2NLvA== } + { integrity: sha512-0lgOZB8cl19fHO4eI46YUx2EceQqhgkPSuCGLlGi79L2jwYY1cxeYc1Nae8Aw1xjgW3PKVDLlr3YJ6Bxx8HkWg== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/type-utils@8.57.0": + "@typescript-eslint/type-utils@8.57.1": resolution: - { integrity: sha512-yjgh7gmDcJ1+TcEg8x3uWQmn8ifvSupnPfjP21twPKrDP/pTHlEQgmKcitzF/rzPSmv7QjJ90vRpN4U+zoUjwQ== } + { integrity: sha512-+Bwwm0ScukFdyoJsh2u6pp4S9ktegF98pYUU0hkphOOqdMB+1sNQhIz8y5E9+4pOioZijrkfNO/HUJVAFFfPKA== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 @@ -4255,6 +4405,11 @@ packages: { integrity: sha512-dTLI8PEXhjUC7B9Kre+u0XznO696BhXcTlOn0/6kf1fHaQW8+VjJAVHJ3eTI14ZapTxdkOmc80HblPQLaEeJdg== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } + "@typescript-eslint/types@8.57.1": + resolution: + { integrity: sha512-S29BOBPJSFUiblEl6RzPPjJt6w25A6XsBqRVDt53tA/tlL8q7ceQNZHTjPeONt/3S7KRI4quk+yP9jK2WjBiPQ== } + engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } + "@typescript-eslint/typescript-estree@8.56.1": resolution: { integrity: sha512-qzUL1qgalIvKWAf9C1HpvBjif+Vm6rcT5wZd4VoMb9+Km3iS3Cv9DY6dMRMDtPnwRAFyAi7YXJpTIEXLvdfPxg== } @@ -4262,9 +4417,9 @@ packages: peerDependencies: typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/typescript-estree@8.57.0": + "@typescript-eslint/typescript-estree@8.57.1": resolution: - { integrity: sha512-m7faHcyVg0BT3VdYTlX8GdJEM7COexXxS6KqGopxdtkQRvBanK377QDHr4W/vIPAR+ah9+B/RclSW5ldVniO1Q== } + { integrity: sha512-ybe2hS9G6pXpqGtPli9Gx9quNV0TWLOmh58ADlmZe9DguLq0tiAKVjirSbtM1szG6+QH6rVXyU6GTLQbWnMY+g== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: typescript: ">=4.8.4 <6.0.0" @@ -4277,9 +4432,9 @@ packages: eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 typescript: ">=4.8.4 <6.0.0" - "@typescript-eslint/utils@8.57.0": + "@typescript-eslint/utils@8.57.1": resolution: - { integrity: sha512-5iIHvpD3CZe06riAsbNxxreP+MuYgVUsV0n4bwLH//VJmgtt54sQeY2GszntJ4BjYCpMzrfVh2SBnUQTtys2lQ== } + { integrity: sha512-XUNSJ/lEVFttPMMoDVA2r2bwrl8/oPx8cURtczkSEswY5T3AeLmCy+EKWQNdL4u0MmAHOjcWrqJp2cdvgjn8dQ== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 @@ -4290,9 +4445,9 @@ packages: { integrity: sha512-KiROIzYdEV85YygXw6BI/Dx4fnBlFQu6Mq4QE4MOH9fFnhohw6wX/OAvDY2/C+ut0I3RSPKenvZJIVYqJNkhEw== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } - "@typescript-eslint/visitor-keys@8.57.0": + "@typescript-eslint/visitor-keys@8.57.1": resolution: - { integrity: sha512-zm6xx8UT/Xy2oSr2ZXD0pZo7Jx2XsCoID2IUh9YSTFRu7z+WdwYTRk6LhUftm1crwqbuoF6I8zAFeCMw0YjwDg== } + { integrity: sha512-YWnmJkXbofiz9KbnbbwuA2rpGkFPLbAIetcCNO6mJ8gdhdZ/v7WDXsoGFAJuM6ikUFKTlSQnjWnVO4ux+UzS6A== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } "@vitest/coverage-v8@4.1.0": @@ -4407,34 +4562,6 @@ packages: resolution: { integrity: sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw== } - "@webpack-cli/configtest@3.0.1": - resolution: - { integrity: sha512-u8d0pJ5YFgneF/GuvEiDA61Tf1VDomHHYMjv/wc9XzYj7nopltpG96nXN5dJRstxZhcNpV1g+nT6CydO7pHbjA== } - engines: { node: ">=18.12.0" } - peerDependencies: - webpack: ^5.82.0 - webpack-cli: 6.x.x - - "@webpack-cli/info@3.0.1": - resolution: - { integrity: sha512-coEmDzc2u/ffMvuW9aCjoRzNSPDl/XLuhPdlFRpT9tZHmJ/039az33CE7uH+8s0uL1j5ZNtfdv0HkfaKRBGJsQ== } - engines: { node: ">=18.12.0" } - peerDependencies: - webpack: ^5.82.0 - webpack-cli: 6.x.x - - "@webpack-cli/serve@3.0.1": - resolution: - { integrity: sha512-sbgw03xQaCLiT6gcY/6u3qBDn01CWw/nbaXl3gTdTFuJJ75Gffv3E3DBpgvY2fkkrdS1fpjaXNOmJlnbtKauKg== } - engines: { node: ">=18.12.0" } - peerDependencies: - webpack: ^5.82.0 - webpack-cli: 6.x.x - webpack-dev-server: "*" - peerDependenciesMeta: - webpack-dev-server: - optional: true - "@xtuc/ieee754@1.2.0": resolution: { integrity: sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA== } @@ -4648,11 +4775,6 @@ packages: resolution: { integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q== } - array-differ@3.0.0: - resolution: - { integrity: sha512-THtfYS6KtME/yIAhKjZ2ul7XI96lQGHRputJQHO80LAWQnuGP4iCIN8vdMRboGbIEYBwU33q8Tch1os2+X0kMg== } - engines: { node: ">=8" } - array-ify@1.0.0: resolution: { integrity: sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng== } @@ -4667,11 +4789,6 @@ packages: { integrity: sha512-3CYzex9M9FGQjCGMGyi6/31c8GJbgb0qGyrx5HWxPd0aCwh4cB2YjMb2Xf9UuoogrMrlO9cTqnB5rI5GHZTcUA== } engines: { node: ">=0.10.0" } - arrify@2.0.1: - resolution: - { integrity: sha512-3duEwti880xqi4eAMN8AyR4a0ByT90zoYdLlevfrvU43vb0YZwZVfxOgxWrLXXXpyugL0hNZc9G6BiB5B3nUug== } - engines: { node: ">=8" } - asap@2.0.6: resolution: { integrity: sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA== } @@ -5029,10 +5146,6 @@ packages: { integrity: sha512-ezmVcLR3xAVp8kYOm4GS45ZLLgIE6SPAFoduLr6hTDajwb3KZ2F46gulK3XpcwRFb5KKGCSezCBAY4Dw4HsyXA== } engines: { node: ">=18" } - colorette@2.0.20: - resolution: - { integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w== } - columnify@1.6.0: resolution: { integrity: sha512-lomjuFZKfM6MSAnV9aCZC9sc0qGbmZdfygNv+nCpqVkSKdCxCklLtd16O0EILGkImHw9ZpHkAnHaB+8Zxq5W6Q== } @@ -5048,11 +5161,6 @@ packages: { integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ== } engines: { node: ">=16" } - commander@12.1.0: - resolution: - { integrity: sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA== } - engines: { node: ">=18" } - commander@13.1.0: resolution: { integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw== } @@ -5242,11 +5350,6 @@ packages: engines: { node: ">=20" } hasBin: true - cross-spawn@7.0.3: - resolution: - { integrity: sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w== } - engines: { node: ">= 8" } - cross-spawn@7.0.6: resolution: { integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA== } @@ -5271,6 +5374,11 @@ packages: { integrity: sha512-0eW44TGN5SQXU1mWSkKwFstI/22X2bG1nYzZTYMAWjylYURhse752YgbE4Cx46AC+bAvI+/dYTPRk1LqSUnu6w== } engines: { node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0 } + css-tree@3.2.1: + resolution: + { integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA== } + engines: { node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0 } + css-what@6.2.2: resolution: { integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA== } @@ -5287,11 +5395,6 @@ packages: { integrity: sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ== } engines: { node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: ">=7.0.0" } - cssstyle@6.0.1: - resolution: - { integrity: sha512-IoJs7La+oFp/AB033wBStxNOJt4+9hHMxsXUPANcoXL2b3W4DZKghlJ2cI/eyeRZIQ9ysvYEorVhjrcYctWbog== } - engines: { node: ">=20" } - dargs@7.0.0: resolution: { integrity: sha512-2iy1EkLdlBzQGvbweYRFxmFath8+K7+AKB0TlhHWkNuH+TmovaMH/Wp7V7R4u7f4SnX3OgLsU9t1NI9ioDnUpg== } @@ -5421,11 +5524,6 @@ packages: resolution: { integrity: sha512-xmHIy4F3scKVwMsQ4WnVaS8bHOx0DmVwRywosKhaILI0ywMDWPtBSku2HNxRvF7jtwDRsoEwYQSfbxj8b7RlJQ== } - detect-indent@5.0.0: - resolution: - { integrity: sha512-rlpvsxUtM0PQvy9iZe640/IWwWYyBsTApREbA1pHOpmOUIl9MkP/U4z7vTtg4Oaojvqhxt7sdufnT0EzGaR31g== } - engines: { node: ">=4" } - detect-libc@1.0.3: resolution: { integrity: sha512-pGjwhsmsp4kL2RTz08wcOlGN83otlqHeD/Z5T8GXZB+/YcpQ/dgo+lbU8ZsGxV0HIvqqxo9l7mqYwyYMD9bKDg== } @@ -5525,9 +5623,9 @@ packages: resolution: { integrity: sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw== } - electron@41.0.2: + electron@41.0.3: resolution: - { integrity: sha512-raotm/aO8kOs1jD8SI8ssJ7EKciQOY295AOOprl1TxW7B0At8m5Ae7qNU1xdMxofiHMR8cNEGi9PKD3U+yT/mA== } + { integrity: sha512-IDjx8liW1q+r7+MOip5W1Eo1eMwJzVObmYrd9yz2dPCkS7XlgLq3qPVMR80TpiROFp73iY30kTzMdpA6fEVs3A== } engines: { node: ">= 12.20.55" } hasBin: true @@ -6082,11 +6180,6 @@ packages: engines: { node: ">=6.9.0" } hasBin: true - get-port@5.1.1: - resolution: - { integrity: sha512-g/Q1aTSDOxFpchXC4i8ZWvxA1lnPqx/JHqcpIw0/LX9T8x/GBbi6YnlN5nhaKIFkT8oFsscUKgDJYxfwfS6QsQ== } - engines: { node: ">=8" } - get-proto@1.0.1: resolution: { integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g== } @@ -6495,11 +6588,6 @@ packages: { integrity: sha512-ZYvCgrefwqoQ6yTyYUbQu64HsITZ3NfKX1lzaEYdkTDcfKzzCI/wthRRYKkdjHKFVgNiXKAKm65Zo1pk2as/QQ== } hasBin: true - is-core-module@2.15.1: - resolution: - { integrity: sha512-z0vtXSwucUJtANQWldhbtbt7BnL0vxiFjIdDLAatwhDYty2bad6s+rijD6Ri4YuYJubLzIJLUidCh09e1djEVQ== } - engines: { node: ">= 0.4" } - is-core-module@2.16.1: resolution: { integrity: sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w== } @@ -6591,11 +6679,6 @@ packages: resolution: { integrity: sha512-x7+VxdxOdlV3CYpjvRLBv5Lo9OJerlYanjwFrPR9fuGPjCiNiCzFgAWpiLAohSbsnH4ZAys3SBh+hq5rJosxUQ== } - is-stream@2.0.0: - resolution: - { integrity: sha512-XCoy+WlUr7d1+Z8GgSuXmpuUFC9fOhRXglJMx+dwLKTkL44Cjd4W1Z5P+BQZpr+cR93aGP4S/s7Ftw6Nd/kiEw== } - engines: { node: ">=8" } - is-stream@2.0.1: resolution: { integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg== } @@ -6733,10 +6816,10 @@ packages: peerDependencies: jsdom: ">=10.0.0" - jsdom@28.1.0: + jsdom@29.0.0: resolution: - { integrity: sha512-0+MoQNYyr2rBHqO1xilltfDjV9G7ymYGlAUazgcDLQaUf8JDHbuGwsxN6U9qWaElZ4w1B2r7yEGIL3GdeW3Rug== } - engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } + { integrity: sha512-9FshNB6OepopZ08unmmGpsF7/qCjxGPbo3NbgfJAnPeHXnsODE9WWffXZtRFRFe0ntzaAOcSKNJFz8wiyvF1jQ== } + engines: { node: ^20.19.0 || ^22.13.0 || >=24.0.0 } peerDependencies: canvas: ^3.0.0 peerDependenciesMeta: @@ -6856,9 +6939,9 @@ packages: resolution: { integrity: sha512-Xq9nH7KlWZmXAtodXDDRE7vs6DU1gTU8zYDHDiWLSip45Egwq3plLHzPn27NgvzL2r1LMPC1vdqh98sQxtqj4A== } - lerna@9.0.6: + lerna@9.0.7: resolution: - { integrity: sha512-ylCTTq8QOa2oRBDhQhy8UIFob6wJZTdREjXTtMJzoB9eWk8qbI0qyIAYmFClu0NVN3mTZ2UKN1HFgTpg4hCdmQ== } + { integrity: sha512-PMjbSWYfwL1yZ5c1D2PZuFyzmtYhLdn0f76uG8L25g6eYy34j+2jPb4Q6USx1UJvxVtxkdVEeAAWS/WxgJ8VZA== } engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } hasBin: true @@ -6884,13 +6967,6 @@ packages: cpu: [arm64] os: [android] - lightningcss-android-arm64@1.31.1: - resolution: - { integrity: sha512-HXJF3x8w9nQ4jbXRiNppBCqeZPIAfUo8zE/kOEGbW5NZvGc/K7nMxbhIr+YlFlHW5mpbg/YFPdbnCh1wAXCKFg== } - engines: { node: ">= 12.0.0" } - cpu: [arm64] - os: [android] - lightningcss-android-arm64@1.32.0: resolution: { integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg== } @@ -6905,13 +6981,6 @@ packages: cpu: [arm64] os: [darwin] - lightningcss-darwin-arm64@1.31.1: - resolution: - { integrity: sha512-02uTEqf3vIfNMq3h/z2cJfcOXnQ0GRwQrkmPafhueLb2h7mqEidiCzkE4gBMEH65abHRiQvhdcQ+aP0D0g67sg== } - engines: { node: ">= 12.0.0" } - cpu: [arm64] - os: [darwin] - lightningcss-darwin-arm64@1.32.0: resolution: { integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ== } @@ -6926,13 +6995,6 @@ packages: cpu: [x64] os: [darwin] - lightningcss-darwin-x64@1.31.1: - resolution: - { integrity: sha512-1ObhyoCY+tGxtsz1lSx5NXCj3nirk0Y0kB/g8B8DT+sSx4G9djitg9ejFnjb3gJNWo7qXH4DIy2SUHvpoFwfTA== } - engines: { node: ">= 12.0.0" } - cpu: [x64] - os: [darwin] - lightningcss-darwin-x64@1.32.0: resolution: { integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w== } @@ -6947,13 +7009,6 @@ packages: cpu: [x64] os: [freebsd] - lightningcss-freebsd-x64@1.31.1: - resolution: - { integrity: sha512-1RINmQKAItO6ISxYgPwszQE1BrsVU5aB45ho6O42mu96UiZBxEXsuQ7cJW4zs4CEodPUioj/QrXW1r9pLUM74A== } - engines: { node: ">= 12.0.0" } - cpu: [x64] - os: [freebsd] - lightningcss-freebsd-x64@1.32.0: resolution: { integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig== } @@ -6968,13 +7023,6 @@ packages: cpu: [arm] os: [linux] - lightningcss-linux-arm-gnueabihf@1.31.1: - resolution: - { integrity: sha512-OOCm2//MZJ87CdDK62rZIu+aw9gBv4azMJuA8/KB74wmfS3lnC4yoPHm0uXZ/dvNNHmnZnB8XLAZzObeG0nS1g== } - engines: { node: ">= 12.0.0" } - cpu: [arm] - os: [linux] - lightningcss-linux-arm-gnueabihf@1.32.0: resolution: { integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw== } @@ -6990,14 +7038,6 @@ packages: os: [linux] libc: [glibc] - lightningcss-linux-arm64-gnu@1.31.1: - resolution: - { integrity: sha512-WKyLWztD71rTnou4xAD5kQT+982wvca7E6QoLpoawZ1gP9JM0GJj4Tp5jMUh9B3AitHbRZ2/H3W5xQmdEOUlLg== } - engines: { node: ">= 12.0.0" } - cpu: [arm64] - os: [linux] - libc: [glibc] - lightningcss-linux-arm64-gnu@1.32.0: resolution: { integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ== } @@ -7014,14 +7054,6 @@ packages: os: [linux] libc: [musl] - lightningcss-linux-arm64-musl@1.31.1: - resolution: - { integrity: sha512-mVZ7Pg2zIbe3XlNbZJdjs86YViQFoJSpc41CbVmKBPiGmC4YrfeOyz65ms2qpAobVd7WQsbW4PdsSJEMymyIMg== } - engines: { node: ">= 12.0.0" } - cpu: [arm64] - os: [linux] - libc: [musl] - lightningcss-linux-arm64-musl@1.32.0: resolution: { integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg== } @@ -7038,14 +7070,6 @@ packages: os: [linux] libc: [glibc] - lightningcss-linux-x64-gnu@1.31.1: - resolution: - { integrity: sha512-xGlFWRMl+0KvUhgySdIaReQdB4FNudfUTARn7q0hh/V67PVGCs3ADFjw+6++kG1RNd0zdGRlEKa+T13/tQjPMA== } - engines: { node: ">= 12.0.0" } - cpu: [x64] - os: [linux] - libc: [glibc] - lightningcss-linux-x64-gnu@1.32.0: resolution: { integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA== } @@ -7062,14 +7086,6 @@ packages: os: [linux] libc: [musl] - lightningcss-linux-x64-musl@1.31.1: - resolution: - { integrity: sha512-eowF8PrKHw9LpoZii5tdZwnBcYDxRw2rRCyvAXLi34iyeYfqCQNA9rmUM0ce62NlPhCvof1+9ivRaTY6pSKDaA== } - engines: { node: ">= 12.0.0" } - cpu: [x64] - os: [linux] - libc: [musl] - lightningcss-linux-x64-musl@1.32.0: resolution: { integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg== } @@ -7085,13 +7101,6 @@ packages: cpu: [arm64] os: [win32] - lightningcss-win32-arm64-msvc@1.31.1: - resolution: - { integrity: sha512-aJReEbSEQzx1uBlQizAOBSjcmr9dCdL3XuC/6HLXAxmtErsj2ICo5yYggg1qOODQMtnjNQv2UHb9NpOuFtYe4w== } - engines: { node: ">= 12.0.0" } - cpu: [arm64] - os: [win32] - lightningcss-win32-arm64-msvc@1.32.0: resolution: { integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw== } @@ -7106,13 +7115,6 @@ packages: cpu: [x64] os: [win32] - lightningcss-win32-x64-msvc@1.31.1: - resolution: - { integrity: sha512-I9aiFrbd7oYHwlnQDqr1Roz+fTz61oDDJX7n9tYF9FJymH1cIN1DtKw3iYt6b8WZgEjoNwVSncwF4wx/ZedMhw== } - engines: { node: ">= 12.0.0" } - cpu: [x64] - os: [win32] - lightningcss-win32-x64-msvc@1.32.0: resolution: { integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q== } @@ -7125,11 +7127,6 @@ packages: { integrity: sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ== } engines: { node: ">= 12.0.0" } - lightningcss@1.31.1: - resolution: - { integrity: sha512-l51N2r93WmGUye3WuFoN5k10zyvrVs0qfKBhyC5ogUQ6Ew6JUSswh78mbSO+IU3nTWsyOArqPCcShdQSadghBQ== } - engines: { node: ">= 12.0.0" } - lightningcss@1.32.0: resolution: { integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ== } @@ -7250,9 +7247,9 @@ packages: resolution: { integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ== } - lru-cache@11.2.6: + lru-cache@11.2.7: resolution: - { integrity: sha512-ESL2CrkS/2wTPfuend7Zhkzo2u0daGJ/A2VucJOgQ/C48S/zB8MMeMHSGKYpXhIjbPxfuezITkaBH1wqv00DDQ== } + { integrity: sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA== } engines: { node: 20 || >=22 } lru-cache@6.0.0: @@ -7277,11 +7274,6 @@ packages: resolution: { integrity: sha512-E3ZJh4J3S9KfwdjZhe2afj6R9lGIN5Pher1pF39UGrXRqq/VDaGVIGN13BjHd2u8B61hArAGOnso7nBOouW3TQ== } - make-dir@2.1.0: - resolution: - { integrity: sha512-LS9X+dc8KLxXCb8dni79fLIIUA5VyZoyjSMCwTluaXA0o27cCK0bhXkpgw+sTXVpPy/lSO57ilRixqk0vDmtRA== } - engines: { node: ">=6" } - make-dir@3.1.0: resolution: { integrity: sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw== } @@ -7339,6 +7331,10 @@ packages: resolution: { integrity: sha512-IEn+pegP1aManZuckezWCO+XZQDplx1366JoVhTpMpBB1sPey/SbveZQUosKiKiGYjg1wH4pMlNgXbCiYgihQA== } + mdn-data@2.27.1: + resolution: + { integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ== } + mdurl@2.0.0: resolution: { integrity: sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w== } @@ -7557,11 +7553,6 @@ packages: resolution: { integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA== } - multimatch@5.0.0: - resolution: - { integrity: sha512-ypMKuglUrZUD99Tk2bUQ+xNQj43lPEfAeX2o9cTteAmShXy2VHDJpuwu1o0xqoKCt9jLVAvwyFKdLTPXKAfJyA== } - engines: { node: ">=10" } - mute-stream@2.0.0: resolution: { integrity: sha512-WWdIxpyjEn+FhQJQQv9aQAYlHoNVdzIzUySNV1gHUPDSdZJ3yZn7pAAbQcV7B56Mvu881q9FZV+0Vx2xC44VWA== } @@ -7743,9 +7734,9 @@ packages: { integrity: sha512-f24vd5/57/MFSXNMfkerdDiK0EvScGOKO71iOWgJNgI1xVweDRmOA/EfjnPMRd5m+pnoPs/4A7DzuwSW0jZVyw== } hasBin: true - nx@22.5.4: + nx@22.6.0: resolution: - { integrity: sha512-L8wL7uCjnmpyvq4r2mN9s+oriUE4lY+mX9VgOpjj0ucRd5nzaEaBQppVs0zQGkbKC0BnHS8PGtnAglspd5Gh1Q== } + { integrity: sha512-pKkq/ZP2/4YcAQlDOQvtCmPz/gpTgn1AfBiYhcyKX970MilvK6lqb9u/PTLfbi146oqPyEmphupV8YsORDvJ6A== } hasBin: true peerDependencies: "@swc-node/register": ^1.11.1 @@ -8083,16 +8074,6 @@ packages: { integrity: sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg== } engines: { node: ">=4" } - pify@4.0.1: - resolution: - { integrity: sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g== } - engines: { node: ">=6" } - - pify@5.0.0: - resolution: - { integrity: sha512-eW/gHNMlxdSP6dmG6uJip6FXN0EQBwm2clYYd8Wul42Cwu/DK8HEftzsapcNdYe2MfLiIwZqsDk2RDEsTE79hA== } - engines: { node: ">=10" } - pkg-dir@4.2.0: resolution: { integrity: sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ== } @@ -8125,9 +8106,9 @@ packages: { integrity: sha512-SxToR7P8Y2lWmv/kTzVLC1t/GDI2WGjMwNhLLE9qtH8Q13C+aEmuRlzDst4Up4s0Wc8sF2M+J57iB3cMLqftfg== } engines: { node: ">=6.0.0" } - prettier-plugin-multiline-arrays@4.1.4: + prettier-plugin-multiline-arrays@4.1.5: resolution: - { integrity: sha512-33xcBKg7UC5rEKCkPn5LyB3f0mqK4wd+W5rzGO6gbps8jxAHnO/t95SuGqz6TR09ysXUjaKu1m5rknBVzlhKlw== } + { integrity: sha512-eDrP12o6egIqvPg8eCAt94L/jxzMwU6vrOOBooe3FdUPh2h4cfu90ixH1keAkqPyArM2wPsNTBCZo+tY948UdA== } engines: { node: ">=20" } peerDependencies: prettier: ">=3.0.0 <4.0.0" @@ -8220,9 +8201,9 @@ packages: resolution: { integrity: sha512-azINV9dUtzPMFQktvTXciNAfAuVh/L/JCl0vtPCwvOA21uZrC08K/UnmrL+SXGEVc1FwzjW62+xw5S/uaLj6cA== } - pug-code-gen@3.0.3: + pug-code-gen@3.0.4: resolution: - { integrity: sha512-cYQg0JW0w32Ux+XTeZnBEeuWrAY7/HNE6TWnhiHGnnRYlCgyAUPoyh9KzCMa9WhcJlJ1AtQqpEYHc+vbCzA+Aw== } + { integrity: sha512-6okWYIKdasTyXICyEtvobmTZAVX57JkzgzIi4iRJlin8kmhG+Xry2dsus+Mun/nGCn6F2U49haHI5mkELXB14g== } pug-error@2.1.0: resolution: @@ -8260,9 +8241,9 @@ packages: resolution: { integrity: sha512-yYELe9Q5q9IQhuvqsZNwA5hfPkMJ8u92bQLIMcsMxf/VADjNtEYptU+inlufAFYcWdHlwNfZOEnOOQrZrcyJCQ== } - pug@3.0.3: + pug@3.0.4: resolution: - { integrity: sha512-uBi6kmc9f3SZ3PXxqcHiUZLmIXgfgWooKWXcwSGwQd2Zi5Rb0bT14+8CJjJgI8AB+nndLaNgHGrcc6bPIB665g== } + { integrity: sha512-kFfq5mMzrS7+wrl5pLJzZEzemx34OQ0w4SARfhy/3yxTlhbstsudDwJzhf1hP02yHzbjoVMSXUj/Sz6RNfMyXg== } pump@3.0.3: resolution: @@ -8439,11 +8420,6 @@ packages: engines: { node: ">= 0.4" } hasBin: true - resolve@1.22.8: - resolution: - { integrity: sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw== } - hasBin: true - responselike@2.0.1: resolution: { integrity: sha512-4gl03wn3hj1HP3yzgdI7d3lCkF95F21Pz4BPGvKHinyQzALR5CapwC8yIi0Rh58DEMQ/SguC03wFj2k0M/mHhw== } @@ -8480,12 +8456,18 @@ packages: { integrity: sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A== } engines: { node: ">=8.0" } - rolldown@1.0.0-rc.9: + rolldown@1.0.0-rc.10: resolution: - { integrity: sha512-9EbgWge7ZH+yqb4d2EnELAntgPTWbfL8ajiTW+SyhJEC4qhBbkCKbqFV4Ge4zmu5ziQuVbWxb/XwLZ+RIO7E8Q== } + { integrity: sha512-q7j6vvarRFmKpgJUT8HCAUljkgzEp4LAhPlJUvQhA5LA1SUL36s5QCysMutErzL3EbNOZOkoziSx9iZC4FddKA== } engines: { node: ^20.19.0 || >=22.12.0 } hasBin: true + rollup@4.59.0: + resolution: + { integrity: sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg== } + engines: { node: ">=18.0.0", npm: ">=8.0.0" } + hasBin: true + router@2.2.0: resolution: { integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ== } @@ -8596,10 +8578,6 @@ packages: { integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw== } engines: { node: ">= 18" } - set-blocking@2.0.0: - resolution: - { integrity: sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw== } - set-function-length@1.2.2: resolution: { integrity: sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg== } @@ -8709,11 +8687,6 @@ packages: { integrity: sha512-HLpt+uLy/pxB+bum/9DzAgiKS8CX1EvbWxI4zlmgGCExImLdiad2iCwXT5Z4c9c3Eq8rP2318mPW2c+QbtjK8A== } engines: { node: ">= 10.0.0", npm: ">= 3.0.0" } - sort-keys@2.0.0: - resolution: - { integrity: sha512-/dPCrG1s3ePpWm6yBbxZq5Be1dXGLyLn9Z791chDC3NFrpkVbWGzkBwPN1knaciexFXgRJ7hzdnwZ4stHSDmjg== } - engines: { node: ">=4" } - source-map-js@1.2.1: resolution: { integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA== } @@ -8955,11 +8928,6 @@ packages: { integrity: sha512-ChjMH33/KetonMTAtpYdgUFr0tbz69Fp2v7zWxQfYZX4g5ZN2nOBXm1R2xyA+lMIKrLKIoKAwFj93jE/avX9cQ== } engines: { node: ">=18" } - temp-dir@1.0.0: - resolution: - { integrity: sha512-xZFXEGbG7SNC3itwBzI3RYjq/cEhBkx2hJuKGIUOcEULmkQExXiHat2z/qkISYsuR+IKumhEfKKbV5qXmhICFQ== } - engines: { node: ">=4" } - terser-webpack-plugin@5.4.0: resolution: { integrity: sha512-Bn5vxm48flOIfkdl5CaD2+1CiUVbonWQ3KQPyP7/EuIl9Gbzq/gQFOzaMFUEgVjB1396tcK0SG8XcNJ/2kDH8g== } @@ -9073,9 +9041,9 @@ packages: { integrity: sha512-WBx8Uy5TLtOSRtIq+M03/sKDrXCLHxwDcquSP2c43Le03/9serjQBIztjRz6FkJez9D/hleyAXTBGLwwZUw9lA== } hasBin: true - tough-cookie@6.0.0: + tough-cookie@6.0.1: resolution: - { integrity: sha512-kXuRi1mtaKMrsLUxz3sQYvVl37B0Ns6MzfrtV5DvJceE9bPyspOqk9xxv7XbZWcfLWbFmm997vl83qUWVJA64w== } + { integrity: sha512-LktZQb3IeoUWB9lqR5EWTHgW/VTITCXg4D21M+lvybRVdylLrRMnqaIONLVb5mav8vM19m44HIcGq4qASeu2Qw== } engines: { node: ">=16" } tr46@0.0.3: @@ -9193,11 +9161,6 @@ packages: { integrity: sha512-OIAYXk8+ISY+qTOwkHtKqzAuxchoMiD9Udx+FSGQDuiRR+PJKJHc2NJAXlbhkGwTt/4/nKZxELY1w3ReWOL8mw== } engines: { node: ">=10" } - type-fest@0.4.1: - resolution: - { integrity: sha512-IwzA/LSfD2vC1/YDYMv/zHP4rDF1usCwllsDpbolT3D4fUepIO7f9K70jjmUewU/LmGUKJcwcVtDCpnKk4BPMw== } - engines: { node: ">=6" } - type-fest@0.6.0: resolution: { integrity: sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg== } @@ -9272,9 +9235,9 @@ packages: peerDependencies: typescript: 5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x || 5.6.x || 5.7.x || 5.8.x || 5.9.x - typescript-eslint@8.57.0: + typescript-eslint@8.57.1: resolution: - { integrity: sha512-W8GcigEMEeB07xEZol8oJ26rigm3+bfPHxHvwbYUlu1fUDsGuQ7Hiskx5xGW/xM4USc9Ephe3jtv7ZYPQntHeA== } + { integrity: sha512-fLvZWf+cAGw3tqMCYzGIU6yR8K+Y9NT2z23RwOjlNFF2HwSB3KhdEFI5lSBv8tNmFkkBShSjsCjzx1vahZfISA== } engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 } peerDependencies: eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 @@ -9327,9 +9290,9 @@ packages: resolution: { integrity: sha512-RKZvifiL60xdsIuC80UY0dq8Z7DbJUV8/l2hOVbyZAxBzEeQU4Z58+4ZzJ6WN2Lidi9KzT5EbiGX+PI/UGYuRw== } - undici@7.22.0: + undici@7.24.3: resolution: - { integrity: sha512-RqslV2Us5BrllB+JeiZnK4peryVTndy9Dnqq62S3yYRRTj0tFQCwEniUy2167skdGOy3vqRzEvl1Dm4sV2ReDg== } + { integrity: sha512-eJdUmK/Wrx2d+mnWWmwwLRyA7OQCkLap60sk3dOK4ViZR7DKwwptwuIvFBg2HaiP9ESaEdhtpSymQPvytpmkCA== } engines: { node: ">=20.18.1" } unicorn-magic@0.3.0: @@ -9391,11 +9354,6 @@ packages: resolution: { integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw== } - uuid@11.1.0: - resolution: - { integrity: sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A== } - hasBin: true - v8-compile-cache-lib@3.0.1: resolution: { integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg== } @@ -9418,14 +9376,55 @@ packages: { integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg== } engines: { node: ">= 0.8" } - vite@8.0.0: + vite@7.3.1: + resolution: + { integrity: sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA== } + engines: { node: ^20.19.0 || >=22.12.0 } + hasBin: true + peerDependencies: + "@types/node": ^20.19.0 || >=22.12.0 + jiti: ">=1.21.0" + less: ^4.0.0 + lightningcss: ^1.21.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: ">=0.54.8" + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + "@types/node": + optional: true + jiti: + optional: true + less: + optional: true + lightningcss: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + vite@8.0.1: resolution: - { integrity: sha512-fPGaRNj9Zytaf8LEiBhY7Z6ijnFKdzU/+mL8EFBaKr7Vw1/FWcTBAMW0wLPJAGMPX38ZPVCVgLceWiEqeoqL2Q== } + { integrity: sha512-wt+Z2qIhfFt85uiyRt5LPU4oVEJBXj8hZNWKeqFG4gRG/0RaRGJ7njQCwzFVjO+v4+Ipmf5CY7VdmZRAYYBPHw== } engines: { node: ^20.19.0 || >=22.12.0 } hasBin: true peerDependencies: "@types/node": ^20.19.0 || >=22.12.0 - "@vitejs/devtools": ^0.0.0-alpha.31 + "@vitejs/devtools": ^0.1.0 esbuild: ^0.27.0 jiti: ">=1.21.0" less: ^4.0.0 @@ -9549,15 +9548,15 @@ packages: engines: { node: ">= 20.9.0" } hasBin: true - webpack-cli@6.0.1: + webpack-cli@7.0.2: resolution: - { integrity: sha512-MfwFQ6SfwinsUVi0rNJm7rHZ31GyTcpVE5pgVA3hwFRb7COD4TzjUUwhGWKfO50+xdc2MQPuEBBJoqIMGt3JDw== } - engines: { node: ">=18.12.0" } + { integrity: sha512-dB0R4T+C/8YuvM+fabdvil6QE44/ChDXikV5lOOkrUeCkW5hTJv2pGLE3keh+D5hjYw8icBaJkZzpFoaHV4T+g== } + engines: { node: ">=20.9.0" } hasBin: true peerDependencies: - webpack: ^5.82.0 - webpack-bundle-analyzer: "*" - webpack-dev-server: "*" + webpack: ^5.101.0 + webpack-bundle-analyzer: ^4.0.0 || ^5.0.0 + webpack-dev-server: ^5.0.0 peerDependenciesMeta: webpack-bundle-analyzer: optional: true @@ -9590,9 +9589,9 @@ packages: { integrity: sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw== } engines: { node: ">=20" } - whatwg-url@16.0.0: + whatwg-url@16.0.1: resolution: - { integrity: sha512-9CcxtEKsf53UFwkSUZjG+9vydAsFO4lFHBpJUtjBcoJOCJpKnSJNwCw813zrYJHpCJ7sgfbtOe0V5Ku7Pa1XMQ== } + { integrity: sha512-1to4zXBxmXHV3IiSSEInrreIlu02vUOvrhxJJH5vcxYTBDAx51cqZiKdyTxlecdKNSjj8EcxGBxNf6Vg+945gw== } engines: { node: ^20.19.0 || ^22.12.0 || >=24.0.0 } whatwg-url@5.0.0: @@ -9674,10 +9673,6 @@ packages: resolution: { integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ== } - write-file-atomic@2.4.3: - resolution: - { integrity: sha512-GaETH5wwsX+GcnzhPgKcKjJ6M2Cq3/iZp1WyY/X1CSqrW+jVNM9Y7D8EC2sM4ZG/V8wZlSniJnCKWPmBYAucRQ== } - write-file-atomic@5.0.1: resolution: { integrity: sha512-+QU2zd6OTD8XWIJCbffaiQeH9U73qIqafo1x6V1snCWYGJf6cVE0cDR4D8xRzcEnfI21IFrUPzPGtcPf8AC+Rw== } @@ -9688,16 +9683,6 @@ packages: { integrity: sha512-GmqrO8WJ1NuzJ2DrziEI2o57jKAVIQNf8a18W3nCYU3H7PNWqCCVTeH6/NQE93CIllIgQS98rrmVkYgTX9fFJQ== } engines: { node: ^18.17.0 || >=20.5.0 } - write-json-file@3.2.0: - resolution: - { integrity: sha512-3xZqT7Byc2uORAatYiP3DHUUAVEkNOswEWNs9H5KXiicRTvzYzYqKjYc4G7p+8pltvAw641lVByKVtMpf+4sYQ== } - engines: { node: ">=6" } - - write-pkg@4.0.0: - resolution: - { integrity: sha512-v2UQ+50TNf2rNHJ8NyWttfm/EJUBWMJcx6ZTYZr6Qp52uuegWw/lBkCtCbnYZEmPRNL61m+u67dAmGxo+HTULA== } - engines: { node: ">=8" } - ws@8.18.3: resolution: { integrity: sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg== } @@ -9815,25 +9800,23 @@ packages: snapshots: "@aashutoshrathi/word-wrap@1.2.6": {} - "@acemir/cssom@0.9.31": {} - "@adobe/css-tools@4.3.3": {} - "@asamuzakjp/css-color@4.1.2": + "@asamuzakjp/css-color@5.0.1": dependencies: "@csstools/css-calc": 3.1.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) - "@csstools/css-color-parser": 4.0.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + "@csstools/css-color-parser": 4.0.2(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) "@csstools/css-parser-algorithms": 4.0.0(@csstools/css-tokenizer@4.0.0) "@csstools/css-tokenizer": 4.0.0 - lru-cache: 11.2.6 + lru-cache: 11.2.7 - "@asamuzakjp/dom-selector@6.8.1": + "@asamuzakjp/dom-selector@7.0.3": dependencies: "@asamuzakjp/nwsapi": 2.3.9 bidi-js: 1.0.3 - css-tree: 3.1.0 + css-tree: 3.2.1 is-potential-custom-element-name: 1.0.1 - lru-cache: 11.2.6 + lru-cache: 11.2.7 "@asamuzakjp/nwsapi@2.3.9": {} @@ -9874,19 +9857,10 @@ snapshots: "@babel/helper-validator-identifier@7.28.5": {} - "@babel/parser@7.28.6": - dependencies: - "@babel/types": 7.28.6 - "@babel/parser@7.29.0": dependencies: "@babel/types": 7.29.0 - "@babel/types@7.28.6": - dependencies: - "@babel/helper-string-parser": 7.27.1 - "@babel/helper-validator-identifier": 7.28.5 - "@babel/types@7.29.0": dependencies: "@babel/helper-string-parser": 7.27.1 @@ -9896,17 +9870,17 @@ snapshots: "@bramus/specificity@2.4.2": dependencies: - css-tree: 3.1.0 + css-tree: 3.2.1 "@colors/colors@1.6.0": {} - "@commitlint/cli@20.4.4(@types/node@25.5.0)(conventional-commits-parser@6.3.0)(typescript@5.9.3)": + "@commitlint/cli@20.5.0(@types/node@25.5.0)(conventional-commits-parser@6.3.0)(typescript@5.9.3)": dependencies: - "@commitlint/format": 20.4.4 - "@commitlint/lint": 20.4.4 - "@commitlint/load": 20.4.4(@types/node@25.5.0)(typescript@5.9.3) - "@commitlint/read": 20.4.4(conventional-commits-parser@6.3.0) - "@commitlint/types": 20.4.4 + "@commitlint/format": 20.5.0 + "@commitlint/lint": 20.5.0 + "@commitlint/load": 20.5.0(@types/node@25.5.0)(typescript@5.9.3) + "@commitlint/read": 20.5.0(conventional-commits-parser@6.3.0) + "@commitlint/types": 20.5.0 tinyexec: 1.0.2 yargs: 17.7.2 transitivePeerDependencies: @@ -9915,19 +9889,19 @@ snapshots: - conventional-commits-parser - typescript - "@commitlint/config-conventional@20.4.4": + "@commitlint/config-conventional@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 conventional-changelog-conventionalcommits: 9.3.0 - "@commitlint/config-validator@20.4.4": + "@commitlint/config-validator@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 ajv: 8.18.0 - "@commitlint/ensure@20.4.4": + "@commitlint/ensure@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 lodash.camelcase: 4.3.0 lodash.kebabcase: 4.1.1 lodash.snakecase: 4.1.1 @@ -9936,29 +9910,29 @@ snapshots: "@commitlint/execute-rule@20.0.0": {} - "@commitlint/format@20.4.4": + "@commitlint/format@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 picocolors: 1.1.1 - "@commitlint/is-ignored@20.4.4": + "@commitlint/is-ignored@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 semver: 7.7.4 - "@commitlint/lint@20.4.4": + "@commitlint/lint@20.5.0": dependencies: - "@commitlint/is-ignored": 20.4.4 - "@commitlint/parse": 20.4.4 - "@commitlint/rules": 20.4.4 - "@commitlint/types": 20.4.4 + "@commitlint/is-ignored": 20.5.0 + "@commitlint/parse": 20.5.0 + "@commitlint/rules": 20.5.0 + "@commitlint/types": 20.5.0 - "@commitlint/load@20.4.4(@types/node@25.5.0)(typescript@5.9.3)": + "@commitlint/load@20.5.0(@types/node@25.5.0)(typescript@5.9.3)": dependencies: - "@commitlint/config-validator": 20.4.4 + "@commitlint/config-validator": 20.5.0 "@commitlint/execute-rule": 20.0.0 - "@commitlint/resolve-extends": 20.4.4 - "@commitlint/types": 20.4.4 + "@commitlint/resolve-extends": 20.5.0 + "@commitlint/types": 20.5.0 cosmiconfig: 9.0.1(typescript@5.9.3) cosmiconfig-typescript-loader: 6.1.0(@types/node@25.5.0)(cosmiconfig@9.0.1(typescript@5.9.3))(typescript@5.9.3) is-plain-obj: 4.1.0 @@ -9970,16 +9944,16 @@ snapshots: "@commitlint/message@20.4.3": {} - "@commitlint/parse@20.4.4": + "@commitlint/parse@20.5.0": dependencies: - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 conventional-changelog-angular: 8.3.0 conventional-commits-parser: 6.3.0 - "@commitlint/read@20.4.4(conventional-commits-parser@6.3.0)": + "@commitlint/read@20.5.0(conventional-commits-parser@6.3.0)": dependencies: "@commitlint/top-level": 20.4.3 - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 git-raw-commits: 5.0.1(conventional-commits-parser@6.3.0) minimist: 1.2.8 tinyexec: 1.0.2 @@ -9987,21 +9961,21 @@ snapshots: - conventional-commits-filter - conventional-commits-parser - "@commitlint/resolve-extends@20.4.4": + "@commitlint/resolve-extends@20.5.0": dependencies: - "@commitlint/config-validator": 20.4.4 - "@commitlint/types": 20.4.4 + "@commitlint/config-validator": 20.5.0 + "@commitlint/types": 20.5.0 global-directory: 4.0.1 import-meta-resolve: 4.0.0 lodash.mergewith: 4.6.2 resolve-from: 5.0.0 - "@commitlint/rules@20.4.4": + "@commitlint/rules@20.5.0": dependencies: - "@commitlint/ensure": 20.4.4 + "@commitlint/ensure": 20.5.0 "@commitlint/message": 20.4.3 "@commitlint/to-lines": 20.0.0 - "@commitlint/types": 20.4.4 + "@commitlint/types": 20.5.0 "@commitlint/to-lines@20.0.0": {} @@ -10009,7 +9983,7 @@ snapshots: dependencies: escalade: 3.2.0 - "@commitlint/types@20.4.4": + "@commitlint/types@20.5.0": dependencies: conventional-commits-parser: 6.3.0 picocolors: 1.1.1 @@ -10026,16 +10000,16 @@ snapshots: dependencies: "@jridgewell/trace-mapping": 0.3.9 - "@csstools/color-helpers@6.0.1": {} + "@csstools/color-helpers@6.0.2": {} "@csstools/css-calc@3.1.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)": dependencies: "@csstools/css-parser-algorithms": 4.0.0(@csstools/css-tokenizer@4.0.0) "@csstools/css-tokenizer": 4.0.0 - "@csstools/css-color-parser@4.0.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)": + "@csstools/css-color-parser@4.0.2(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)": dependencies: - "@csstools/color-helpers": 6.0.1 + "@csstools/color-helpers": 6.0.2 "@csstools/css-calc": 3.1.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) "@csstools/css-parser-algorithms": 4.0.0(@csstools/css-tokenizer@4.0.0) "@csstools/css-tokenizer": 4.0.0 @@ -10044,7 +10018,9 @@ snapshots: dependencies: "@csstools/css-tokenizer": 4.0.0 - "@csstools/css-syntax-patches-for-csstree@1.0.27": {} + "@csstools/css-syntax-patches-for-csstree@1.1.1(css-tree@3.2.1)": + optionalDependencies: + css-tree: 3.2.1 "@csstools/css-tokenizer@4.0.0": {} @@ -10070,7 +10046,7 @@ snapshots: "@discoveryjs/json-ext@0.5.7": {} - "@discoveryjs/json-ext@0.6.3": {} + "@discoveryjs/json-ext@1.0.0": {} "@electron/get@2.0.3": dependencies: @@ -10086,34 +10062,18 @@ snapshots: transitivePeerDependencies: - supports-color - "@emnapi/core@1.2.0": - dependencies: - "@emnapi/wasi-threads": 1.0.1 - tslib: 2.8.1 - "@emnapi/core@1.8.1": dependencies: "@emnapi/wasi-threads": 1.1.0 tslib: 2.8.1 - optional: true - - "@emnapi/runtime@1.2.0": - dependencies: - tslib: 2.8.1 "@emnapi/runtime@1.8.1": dependencies: tslib: 2.8.1 - optional: true - - "@emnapi/wasi-threads@1.0.1": - dependencies: - tslib: 2.8.1 "@emnapi/wasi-threads@1.1.0": dependencies: tslib: 2.8.1 - optional: true "@epic-web/invariant@1.0.0": {} @@ -10239,7 +10199,7 @@ snapshots: "@eslint/core": 1.1.1 levn: 0.4.1 - "@exodus/bytes@1.11.0": {} + "@exodus/bytes@1.15.0": {} "@fortawesome/fontawesome-free@7.2.0": {} @@ -10441,6 +10401,8 @@ snapshots: "@jridgewell/resolve-uri": 3.1.1 "@jridgewell/sourcemap-codec": 1.5.5 + "@ltd/j-toml@1.38.0": {} + "@microsoft/tsdoc-config@0.18.1": dependencies: "@microsoft/tsdoc": 0.16.0 @@ -10452,8 +10414,8 @@ snapshots: "@napi-rs/wasm-runtime@0.2.4": dependencies: - "@emnapi/core": 1.2.0 - "@emnapi/runtime": 1.2.0 + "@emnapi/core": 1.8.1 + "@emnapi/runtime": 1.8.1 "@tybys/wasm-util": 0.9.0 "@napi-rs/wasm-runtime@1.1.1": @@ -10480,7 +10442,7 @@ snapshots: agent-base: 7.1.3 http-proxy-agent: 7.0.2 https-proxy-agent: 7.0.6 - lru-cache: 11.2.6 + lru-cache: 11.2.7 socks-proxy-agent: 8.0.5 transitivePeerDependencies: - supports-color @@ -10503,7 +10465,7 @@ snapshots: common-ancestor-path: 1.0.1 hosted-git-info: 9.0.2 json-stringify-nice: 1.1.4 - lru-cache: 11.2.6 + lru-cache: 11.2.7 minimatch: 10.2.4 nopt: 8.1.0 npm-install-checks: 7.1.2 @@ -10546,7 +10508,7 @@ snapshots: dependencies: "@npmcli/promise-spawn": 9.0.1 ini: 6.0.0 - lru-cache: 11.2.6 + lru-cache: 11.2.7 npm-pick-manifest: 11.0.3 proc-log: 6.1.0 promise-retry: 2.0.1 @@ -10629,45 +10591,45 @@ snapshots: transitivePeerDependencies: - debug - "@nx/devkit@22.3.3(nx@22.5.4(@swc/core@1.15.18))": + "@nx/devkit@22.3.3(nx@22.6.0(@swc/core@1.15.18))": dependencies: "@zkochan/js-yaml": 0.0.7 ejs: 3.1.9 enquirer: 2.3.6 minimatch: 9.0.3 - nx: 22.5.4(@swc/core@1.15.18) + nx: 22.6.0(@swc/core@1.15.18) semver: 7.7.4 tslib: 2.8.1 yargs-parser: 21.1.1 - "@nx/nx-darwin-arm64@22.5.4": + "@nx/nx-darwin-arm64@22.6.0": optional: true - "@nx/nx-darwin-x64@22.5.4": + "@nx/nx-darwin-x64@22.6.0": optional: true - "@nx/nx-freebsd-x64@22.5.4": + "@nx/nx-freebsd-x64@22.6.0": optional: true - "@nx/nx-linux-arm-gnueabihf@22.5.4": + "@nx/nx-linux-arm-gnueabihf@22.6.0": optional: true - "@nx/nx-linux-arm64-gnu@22.5.4": + "@nx/nx-linux-arm64-gnu@22.6.0": optional: true - "@nx/nx-linux-arm64-musl@22.5.4": + "@nx/nx-linux-arm64-musl@22.6.0": optional: true - "@nx/nx-linux-x64-gnu@22.5.4": + "@nx/nx-linux-x64-gnu@22.6.0": optional: true - "@nx/nx-linux-x64-musl@22.5.4": + "@nx/nx-linux-x64-musl@22.6.0": optional: true - "@nx/nx-win32-arm64-msvc@22.5.4": + "@nx/nx-win32-arm64-msvc@22.6.0": optional: true - "@nx/nx-win32-x64-msvc@22.5.4": + "@nx/nx-win32-x64-msvc@22.6.0": optional: true "@octokit/auth-token@4.0.0": {} @@ -10797,9 +10759,7 @@ snapshots: "@oxc-minify/binding-win32-x64-msvc@0.116.0": optional: true - "@oxc-project/runtime@0.115.0": {} - - "@oxc-project/types@0.115.0": {} + "@oxc-project/types@0.120.0": {} "@parcel/watcher-android-arm64@2.5.1": optional: true @@ -10873,54 +10833,129 @@ snapshots: "@putout/minify@6.0.0": {} - "@rolldown/binding-android-arm64@1.0.0-rc.9": + "@rolldown/binding-android-arm64@1.0.0-rc.10": optional: true - "@rolldown/binding-darwin-arm64@1.0.0-rc.9": + "@rolldown/binding-darwin-arm64@1.0.0-rc.10": optional: true - "@rolldown/binding-darwin-x64@1.0.0-rc.9": + "@rolldown/binding-darwin-x64@1.0.0-rc.10": optional: true - "@rolldown/binding-freebsd-x64@1.0.0-rc.9": + "@rolldown/binding-freebsd-x64@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.9": + "@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-arm64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-arm64-gnu@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-arm64-musl@1.0.0-rc.9": + "@rolldown/binding-linux-arm64-musl@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-s390x-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-s390x-gnu@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-x64-gnu@1.0.0-rc.9": + "@rolldown/binding-linux-x64-gnu@1.0.0-rc.10": optional: true - "@rolldown/binding-linux-x64-musl@1.0.0-rc.9": + "@rolldown/binding-linux-x64-musl@1.0.0-rc.10": optional: true - "@rolldown/binding-openharmony-arm64@1.0.0-rc.9": + "@rolldown/binding-openharmony-arm64@1.0.0-rc.10": optional: true - "@rolldown/binding-wasm32-wasi@1.0.0-rc.9": + "@rolldown/binding-wasm32-wasi@1.0.0-rc.10": dependencies: "@napi-rs/wasm-runtime": 1.1.1 optional: true - "@rolldown/binding-win32-arm64-msvc@1.0.0-rc.9": + "@rolldown/binding-win32-arm64-msvc@1.0.0-rc.10": + optional: true + + "@rolldown/binding-win32-x64-msvc@1.0.0-rc.10": + optional: true + + "@rolldown/pluginutils@1.0.0-rc.10": {} + + "@rollup/rollup-android-arm-eabi@4.59.0": + optional: true + + "@rollup/rollup-android-arm64@4.59.0": + optional: true + + "@rollup/rollup-darwin-arm64@4.59.0": + optional: true + + "@rollup/rollup-darwin-x64@4.59.0": + optional: true + + "@rollup/rollup-freebsd-arm64@4.59.0": + optional: true + + "@rollup/rollup-freebsd-x64@4.59.0": + optional: true + + "@rollup/rollup-linux-arm-gnueabihf@4.59.0": + optional: true + + "@rollup/rollup-linux-arm-musleabihf@4.59.0": + optional: true + + "@rollup/rollup-linux-arm64-gnu@4.59.0": optional: true - "@rolldown/binding-win32-x64-msvc@1.0.0-rc.9": + "@rollup/rollup-linux-arm64-musl@4.59.0": optional: true - "@rolldown/pluginutils@1.0.0-rc.9": {} + "@rollup/rollup-linux-loong64-gnu@4.59.0": + optional: true + + "@rollup/rollup-linux-loong64-musl@4.59.0": + optional: true + + "@rollup/rollup-linux-ppc64-gnu@4.59.0": + optional: true + + "@rollup/rollup-linux-ppc64-musl@4.59.0": + optional: true + + "@rollup/rollup-linux-riscv64-gnu@4.59.0": + optional: true + + "@rollup/rollup-linux-riscv64-musl@4.59.0": + optional: true + + "@rollup/rollup-linux-s390x-gnu@4.59.0": + optional: true + + "@rollup/rollup-linux-x64-gnu@4.59.0": + optional: true + + "@rollup/rollup-linux-x64-musl@4.59.0": + optional: true + + "@rollup/rollup-openbsd-x64@4.59.0": + optional: true + + "@rollup/rollup-openharmony-arm64@4.59.0": + optional: true + + "@rollup/rollup-win32-arm64-msvc@4.59.0": + optional: true + + "@rollup/rollup-win32-ia32-msvc@4.59.0": + optional: true + + "@rollup/rollup-win32-x64-gnu@4.59.0": + optional: true + + "@rollup/rollup-win32-x64-msvc@4.59.0": + optional: true "@shikijs/engine-oniguruma@3.20.0": dependencies: @@ -11069,14 +11104,14 @@ snapshots: "@tsconfig/node16@1.0.4": {} - "@tsparticles/cli@3.3.6(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)(webpack-cli@6.0.1)": + "@tsparticles/cli@3.3.8(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)(webpack-cli@7.0.2)": dependencies: "@swc/core": 1.15.18 - "@tsparticles/depcruise-config": 3.3.3(dependency-cruiser@17.3.9) - "@tsparticles/eslint-config": 3.3.3(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) - "@tsparticles/prettier-config": 3.3.3(prettier@3.8.1) - "@tsparticles/tsconfig": 3.3.3(typescript@5.9.3) - "@tsparticles/webpack-plugin": 3.3.3(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1) + "@tsparticles/depcruise-config": 3.3.5(dependency-cruiser@17.3.9) + "@tsparticles/eslint-config": 3.3.5(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) + "@tsparticles/prettier-config": 3.3.5(prettier@3.8.1) + "@tsparticles/tsconfig": 3.3.5(typescript@5.9.3) + "@tsparticles/webpack-plugin": 3.3.5(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1) commander: 14.0.3 dependency-cruiser: 17.3.9 eslint: 10.0.3(jiti@2.6.1) @@ -11088,13 +11123,13 @@ snapshots: lookpath: 1.2.3 path-scurry: 2.0.2 prettier: 3.8.1 - prettier-plugin-multiline-arrays: 4.1.4(prettier@3.8.1) + prettier-plugin-multiline-arrays: 4.1.5(prettier@3.8.1) prompts: 2.4.2 rimraf: 6.1.3 swc-loader: 0.2.7(@swc/core@1.15.18)(webpack@5.105.4) typescript: 5.9.3 - typescript-eslint: 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + typescript-eslint: 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) transitivePeerDependencies: - "@swc/helpers" - "@types/eslint" @@ -11107,15 +11142,15 @@ snapshots: - webpack-cli - webpack-dev-server - "@tsparticles/depcruise-config@3.3.3(dependency-cruiser@17.3.9)": + "@tsparticles/depcruise-config@3.3.5(dependency-cruiser@17.3.9)": dependencies: dependency-cruiser: 17.3.9 - "@tsparticles/eslint-config@3.3.3(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1))": + "@tsparticles/eslint-config@3.3.5(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1))": dependencies: "@eslint/js": 10.0.1(eslint@10.0.3(jiti@2.6.1)) "@stylistic/eslint-plugin": 5.10.0(eslint@10.0.3(jiti@2.6.1)) - "@tsparticles/prettier-config": 3.3.3(prettier@3.8.1) + "@tsparticles/prettier-config": 3.3.5(prettier@3.8.1) eslint: 10.0.3(jiti@2.6.1) eslint-config-prettier: 10.1.8(eslint@10.0.3(jiti@2.6.1)) eslint-plugin-jsdoc: 62.8.0(eslint@10.0.3(jiti@2.6.1)) @@ -11123,42 +11158,42 @@ snapshots: eslint-plugin-tsdoc: 0.5.2(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) jiti: 2.6.1 prettier: 3.8.1 - prettier-plugin-multiline-arrays: 4.1.4(prettier@3.8.1) + prettier-plugin-multiline-arrays: 4.1.5(prettier@3.8.1) typescript: 5.9.3 - typescript-eslint: 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + typescript-eslint: 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) transitivePeerDependencies: - "@types/eslint" - supports-color - "@tsparticles/prettier-config@3.3.3(prettier@3.8.1)": + "@tsparticles/prettier-config@3.3.5(prettier@3.8.1)": dependencies: prettier: 3.8.1 - prettier-plugin-multiline-arrays: 4.1.4(prettier@3.8.1) + prettier-plugin-multiline-arrays: 4.1.5(prettier@3.8.1) - "@tsparticles/tsconfig@3.3.3(typescript@5.9.3)": + "@tsparticles/tsconfig@3.3.5(typescript@5.9.3)": dependencies: typescript: 5.9.3 - "@tsparticles/webpack-plugin@3.3.3(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)": + "@tsparticles/webpack-plugin@3.3.5(@types/eslint@8.56.6)(esbuild@0.27.2)(jiti@2.6.1)": dependencies: "@stylistic/eslint-plugin": 5.10.0(eslint@10.0.3(jiti@2.6.1)) "@swc/core": 1.15.18 - "@tsparticles/eslint-config": 3.3.3(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) - "@tsparticles/prettier-config": 3.3.3(prettier@3.8.1) + "@tsparticles/eslint-config": 3.3.5(@types/eslint@8.56.6)(eslint@10.0.3(jiti@2.6.1)) + "@tsparticles/prettier-config": 3.3.5(prettier@3.8.1) browserslist: 4.28.1 eslint: 10.0.3(jiti@2.6.1) eslint-config-prettier: 10.1.8(eslint@10.0.3(jiti@2.6.1)) eslint-plugin-jsdoc: 62.8.0(eslint@10.0.3(jiti@2.6.1)) eslint-plugin-tsdoc: 0.5.2(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) prettier: 3.8.1 - prettier-plugin-multiline-arrays: 4.1.4(prettier@3.8.1) + prettier-plugin-multiline-arrays: 4.1.5(prettier@3.8.1) swc-loader: 0.2.7(@swc/core@1.15.18)(webpack@5.105.4) terser-webpack-plugin: 5.4.0(@swc/core@1.15.18)(esbuild@0.27.2)(webpack@5.105.4) typescript: 5.9.3 - typescript-eslint: 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + typescript-eslint: 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) webpack-bundle-analyzer: 5.2.0 - webpack-cli: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) + webpack-cli: 7.0.2(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) transitivePeerDependencies: - "@swc/helpers" - "@types/eslint" @@ -11268,8 +11303,6 @@ snapshots: "@types/mime@1.3.2": {} - "@types/minimatch@3.0.5": {} - "@types/minimist@1.2.2": {} "@types/node@18.19.45": @@ -11280,10 +11313,6 @@ snapshots: dependencies: undici-types: 7.16.0 - "@types/node@25.4.0": - dependencies: - undici-types: 7.18.2 - "@types/node@25.5.0": dependencies: undici-types: 7.18.2 @@ -11329,14 +11358,14 @@ snapshots: "@types/node": 25.5.0 optional: true - "@typescript-eslint/eslint-plugin@8.57.0(@typescript-eslint/parser@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3))(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": + "@typescript-eslint/eslint-plugin@8.57.1(@typescript-eslint/parser@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3))(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": dependencies: "@eslint-community/regexpp": 4.12.2 - "@typescript-eslint/parser": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - "@typescript-eslint/scope-manager": 8.57.0 - "@typescript-eslint/type-utils": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - "@typescript-eslint/utils": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - "@typescript-eslint/visitor-keys": 8.57.0 + "@typescript-eslint/parser": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/scope-manager": 8.57.1 + "@typescript-eslint/type-utils": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/utils": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/visitor-keys": 8.57.1 eslint: 10.0.3(jiti@2.6.1) ignore: 7.0.5 natural-compare: 1.4.0 @@ -11345,12 +11374,12 @@ snapshots: transitivePeerDependencies: - supports-color - "@typescript-eslint/parser@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": + "@typescript-eslint/parser@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": dependencies: - "@typescript-eslint/scope-manager": 8.57.0 - "@typescript-eslint/types": 8.57.0 - "@typescript-eslint/typescript-estree": 8.57.0(typescript@5.9.3) - "@typescript-eslint/visitor-keys": 8.57.0 + "@typescript-eslint/scope-manager": 8.57.1 + "@typescript-eslint/types": 8.57.1 + "@typescript-eslint/typescript-estree": 8.57.1(typescript@5.9.3) + "@typescript-eslint/visitor-keys": 8.57.1 debug: 4.4.3(supports-color@5.5.0) eslint: 10.0.3(jiti@2.6.1) typescript: 5.9.3 @@ -11366,10 +11395,10 @@ snapshots: transitivePeerDependencies: - supports-color - "@typescript-eslint/project-service@8.57.0(typescript@5.9.3)": + "@typescript-eslint/project-service@8.57.1(typescript@5.9.3)": dependencies: - "@typescript-eslint/tsconfig-utils": 8.57.0(typescript@5.9.3) - "@typescript-eslint/types": 8.57.0 + "@typescript-eslint/tsconfig-utils": 8.57.1(typescript@5.9.3) + "@typescript-eslint/types": 8.57.1 debug: 4.4.3(supports-color@5.5.0) typescript: 5.9.3 transitivePeerDependencies: @@ -11380,24 +11409,24 @@ snapshots: "@typescript-eslint/types": 8.56.1 "@typescript-eslint/visitor-keys": 8.56.1 - "@typescript-eslint/scope-manager@8.57.0": + "@typescript-eslint/scope-manager@8.57.1": dependencies: - "@typescript-eslint/types": 8.57.0 - "@typescript-eslint/visitor-keys": 8.57.0 + "@typescript-eslint/types": 8.57.1 + "@typescript-eslint/visitor-keys": 8.57.1 "@typescript-eslint/tsconfig-utils@8.56.1(typescript@5.9.3)": dependencies: typescript: 5.9.3 - "@typescript-eslint/tsconfig-utils@8.57.0(typescript@5.9.3)": + "@typescript-eslint/tsconfig-utils@8.57.1(typescript@5.9.3)": dependencies: typescript: 5.9.3 - "@typescript-eslint/type-utils@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": + "@typescript-eslint/type-utils@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": dependencies: - "@typescript-eslint/types": 8.57.0 - "@typescript-eslint/typescript-estree": 8.57.0(typescript@5.9.3) - "@typescript-eslint/utils": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/types": 8.57.1 + "@typescript-eslint/typescript-estree": 8.57.1(typescript@5.9.3) + "@typescript-eslint/utils": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) debug: 4.4.3(supports-color@5.5.0) eslint: 10.0.3(jiti@2.6.1) ts-api-utils: 2.4.0(typescript@5.9.3) @@ -11409,6 +11438,8 @@ snapshots: "@typescript-eslint/types@8.57.0": {} + "@typescript-eslint/types@8.57.1": {} + "@typescript-eslint/typescript-estree@8.56.1(typescript@5.9.3)": dependencies: "@typescript-eslint/project-service": 8.56.1(typescript@5.9.3) @@ -11424,12 +11455,12 @@ snapshots: transitivePeerDependencies: - supports-color - "@typescript-eslint/typescript-estree@8.57.0(typescript@5.9.3)": + "@typescript-eslint/typescript-estree@8.57.1(typescript@5.9.3)": dependencies: - "@typescript-eslint/project-service": 8.57.0(typescript@5.9.3) - "@typescript-eslint/tsconfig-utils": 8.57.0(typescript@5.9.3) - "@typescript-eslint/types": 8.57.0 - "@typescript-eslint/visitor-keys": 8.57.0 + "@typescript-eslint/project-service": 8.57.1(typescript@5.9.3) + "@typescript-eslint/tsconfig-utils": 8.57.1(typescript@5.9.3) + "@typescript-eslint/types": 8.57.1 + "@typescript-eslint/visitor-keys": 8.57.1 debug: 4.4.3(supports-color@5.5.0) minimatch: 10.2.4 semver: 7.7.4 @@ -11450,12 +11481,12 @@ snapshots: transitivePeerDependencies: - supports-color - "@typescript-eslint/utils@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": + "@typescript-eslint/utils@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3)": dependencies: "@eslint-community/eslint-utils": 4.9.1(eslint@10.0.3(jiti@2.6.1)) - "@typescript-eslint/scope-manager": 8.57.0 - "@typescript-eslint/types": 8.57.0 - "@typescript-eslint/typescript-estree": 8.57.0(typescript@5.9.3) + "@typescript-eslint/scope-manager": 8.57.1 + "@typescript-eslint/types": 8.57.1 + "@typescript-eslint/typescript-estree": 8.57.1(typescript@5.9.3) eslint: 10.0.3(jiti@2.6.1) typescript: 5.9.3 transitivePeerDependencies: @@ -11466,9 +11497,9 @@ snapshots: "@typescript-eslint/types": 8.56.1 eslint-visitor-keys: 5.0.0 - "@typescript-eslint/visitor-keys@8.57.0": + "@typescript-eslint/visitor-keys@8.57.1": dependencies: - "@typescript-eslint/types": 8.57.0 + "@typescript-eslint/types": 8.57.1 eslint-visitor-keys: 5.0.1 "@vitest/coverage-v8@4.1.0(vitest@4.1.0)": @@ -11483,7 +11514,7 @@ snapshots: obug: 2.1.1 std-env: 4.0.0 tinyrainbow: 3.0.3 - vitest: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@28.1.0(canvas@3.2.1))(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) + vitest: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@29.0.0(canvas@3.2.1))(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) "@vitest/expect@4.1.0": dependencies: @@ -11494,13 +11525,13 @@ snapshots: chai: 6.2.2 tinyrainbow: 3.0.3 - "@vitest/mocker@4.1.0(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1))": + "@vitest/mocker@4.1.0(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1))": dependencies: "@vitest/spy": 4.1.0 estree-walker: 3.0.3 magic-string: 0.30.21 optionalDependencies: - vite: 8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) + vite: 8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) "@vitest/pretty-format@4.1.0": dependencies: @@ -11529,7 +11560,7 @@ snapshots: sirv: 3.0.2 tinyglobby: 0.2.15 tinyrainbow: 3.0.3 - vitest: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@28.1.0(canvas@3.2.1))(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) + vitest: 4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@29.0.0(canvas@3.2.1))(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) "@vitest/utils@4.1.0": dependencies: @@ -11613,21 +11644,6 @@ snapshots: "@webassemblyjs/ast": 1.14.1 "@xtuc/long": 4.2.2 - "@webpack-cli/configtest@3.0.1(webpack-cli@6.0.1)(webpack@5.105.4)": - dependencies: - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) - webpack-cli: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) - - "@webpack-cli/info@3.0.1(webpack-cli@6.0.1)(webpack@5.105.4)": - dependencies: - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) - webpack-cli: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) - - "@webpack-cli/serve@3.0.1(webpack-cli@6.0.1)(webpack@5.105.4)": - dependencies: - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) - webpack-cli: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) - "@xtuc/ieee754@1.2.0": {} "@xtuc/long@4.2.2": {} @@ -11767,16 +11783,12 @@ snapshots: argparse@2.0.1: {} - array-differ@3.0.0: {} - array-ify@1.0.0: {} array-union@2.1.0: {} arrify@1.0.1: {} - arrify@2.0.1: {} - asap@2.0.6: {} assert-never@1.3.0: {} @@ -11801,7 +11813,7 @@ snapshots: babel-walk@3.0.0-canary-5: dependencies: - "@babel/types": 7.28.6 + "@babel/types": 7.29.0 balanced-match@1.0.2: {} @@ -11901,7 +11913,7 @@ snapshots: "@npmcli/fs": 5.0.0 fs-minipass: 3.0.2 glob: 13.0.6 - lru-cache: 11.2.6 + lru-cache: 11.2.7 minipass: 7.1.3 minipass-collect: 2.0.1 minipass-flush: 1.0.5 @@ -12076,8 +12088,6 @@ snapshots: color-convert: 3.1.3 color-string: 2.1.4 - colorette@2.0.20: {} - columnify@1.6.0: dependencies: strip-ansi: 6.0.1 @@ -12089,8 +12099,6 @@ snapshots: commander@11.1.0: {} - commander@12.1.0: {} - commander@13.1.0: {} commander@14.0.3: {} @@ -12134,8 +12142,8 @@ snapshots: constantinople@4.0.1: dependencies: - "@babel/parser": 7.28.6 - "@babel/types": 7.28.6 + "@babel/parser": 7.29.0 + "@babel/types": 7.29.0 content-disposition@1.0.1: {} @@ -12256,12 +12264,6 @@ snapshots: "@epic-web/invariant": 1.0.0 cross-spawn: 7.0.6 - cross-spawn@7.0.3: - dependencies: - path-key: 3.1.1 - shebang-command: 2.0.0 - which: 2.0.2 - cross-spawn@7.0.6: dependencies: path-key: 3.1.1 @@ -12288,6 +12290,11 @@ snapshots: mdn-data: 2.12.2 source-map-js: 1.2.1 + css-tree@3.2.1: + dependencies: + mdn-data: 2.27.1 + source-map-js: 1.2.1 + css-what@6.2.2: {} cssesc@3.0.0: {} @@ -12296,19 +12303,12 @@ snapshots: dependencies: css-tree: 2.2.1 - cssstyle@6.0.1: - dependencies: - "@asamuzakjp/css-color": 4.1.2 - "@csstools/css-syntax-patches-for-csstree": 1.0.27 - css-tree: 3.1.0 - lru-cache: 11.2.6 - dargs@7.0.0: {} data-urls@7.0.0: dependencies: whatwg-mimetype: 5.0.0 - whatwg-url: 16.0.0 + whatwg-url: 16.0.1 transitivePeerDependencies: - "@noble/hashes" @@ -12397,8 +12397,6 @@ snapshots: deprecation@2.3.1: {} - detect-indent@5.0.0: {} - detect-libc@1.0.3: optional: true @@ -12465,7 +12463,7 @@ snapshots: electron-to-chromium@1.5.267: {} - electron@41.0.2: + electron@41.0.3: dependencies: "@electron/get": 2.0.3 "@types/node": 24.10.9 @@ -12977,8 +12975,6 @@ snapshots: through2: 2.0.5 yargs: 16.2.0 - get-port@5.1.1: {} - get-proto@1.0.1: dependencies: dunder-proto: 1.0.1 @@ -13176,11 +13172,11 @@ snapshots: hosted-git-info@9.0.2: dependencies: - lru-cache: 11.2.6 + lru-cache: 11.2.7 html-encoding-sniffer@6.0.0: dependencies: - "@exodus/bytes": 1.11.0 + "@exodus/bytes": 1.15.0 transitivePeerDependencies: - "@noble/hashes" @@ -13192,7 +13188,7 @@ snapshots: dependencies: commander: 14.0.3 entities: 7.0.1 - lightningcss: 1.31.1 + lightningcss: 1.32.0 svgo: 4.0.1 terser: 5.46.0 optionalDependencies: @@ -13333,10 +13329,6 @@ snapshots: dependencies: ci-info: 3.8.0 - is-core-module@2.15.1: - dependencies: - hasown: 2.0.2 - is-core-module@2.16.1: dependencies: hasown: 2.0.2 @@ -13392,8 +13384,6 @@ snapshots: dependencies: protocols: 2.0.1 - is-stream@2.0.0: {} - is-stream@2.0.1: {} is-text-path@1.0.1: @@ -13486,38 +13476,37 @@ snapshots: jsdoc-type-pratt-parser@7.1.1: {} - jsdom-global@3.0.2(jsdom@28.1.0(canvas@3.2.1)): + jsdom-global@3.0.2(jsdom@29.0.0(canvas@3.2.1)): dependencies: - jsdom: 28.1.0(canvas@3.2.1) + jsdom: 29.0.0(canvas@3.2.1) - jsdom@28.1.0(canvas@3.2.1): + jsdom@29.0.0(canvas@3.2.1): dependencies: - "@acemir/cssom": 0.9.31 - "@asamuzakjp/dom-selector": 6.8.1 + "@asamuzakjp/css-color": 5.0.1 + "@asamuzakjp/dom-selector": 7.0.3 "@bramus/specificity": 2.4.2 - "@exodus/bytes": 1.11.0 - cssstyle: 6.0.1 + "@csstools/css-syntax-patches-for-csstree": 1.1.1(css-tree@3.2.1) + "@exodus/bytes": 1.15.0 + css-tree: 3.2.1 data-urls: 7.0.0 decimal.js: 10.6.0 html-encoding-sniffer: 6.0.0 - http-proxy-agent: 7.0.2 - https-proxy-agent: 7.0.6 is-potential-custom-element-name: 1.0.1 + lru-cache: 11.2.7 parse5: 8.0.0 saxes: 6.0.0 symbol-tree: 3.2.4 - tough-cookie: 6.0.0 - undici: 7.22.0 + tough-cookie: 6.0.1 + undici: 7.24.3 w3c-xmlserializer: 5.0.0 webidl-conversions: 8.0.1 whatwg-mimetype: 5.0.0 - whatwg-url: 16.0.0 + whatwg-url: 16.0.1 xml-name-validator: 5.0.0 optionalDependencies: canvas: 3.2.1 transitivePeerDependencies: - "@noble/hashes" - - supports-color json-buffer@3.0.1: {} @@ -13591,12 +13580,12 @@ snapshots: kuler@2.0.0: {} - lerna@9.0.6(@swc/core@1.15.18)(@types/node@25.5.0): + lerna@9.0.7(@swc/core@1.15.18)(@types/node@25.5.0): dependencies: "@npmcli/arborist": 9.1.6 "@npmcli/package-json": 7.0.2 "@npmcli/run-script": 10.0.3 - "@nx/devkit": 22.3.3(nx@22.5.4(@swc/core@1.15.18)) + "@nx/devkit": 22.3.3(nx@22.6.0(@swc/core@1.15.18)) "@octokit/plugin-enterprise-rest": 6.0.1 "@octokit/rest": 20.1.2 aproba: 2.0.0 @@ -13615,7 +13604,6 @@ snapshots: envinfo: 7.13.0 execa: 5.0.0 fs-extra: 11.3.4 - get-port: 5.1.1 get-stream: 6.0.0 git-url-parse: 14.0.0 glob-parent: 6.0.2 @@ -13625,20 +13613,17 @@ snapshots: init-package-json: 8.2.2 inquirer: 12.9.6(@types/node@25.5.0) is-ci: 3.0.1 - is-stream: 2.0.0 jest-diff: 30.2.0 js-yaml: 4.1.1 libnpmaccess: 10.0.3 libnpmpublish: 11.1.2 load-json-file: 6.2.0 - make-dir: 4.0.0 make-fetch-happen: 15.0.2 minimatch: 3.1.4 - multimatch: 5.0.0 npm-package-arg: 13.0.1 npm-packlist: 10.0.3 npm-registry-fetch: 19.1.0 - nx: 22.5.4(@swc/core@1.15.18) + nx: 22.6.0(@swc/core@1.15.18) p-map: 4.0.0 p-map-series: 2.1.0 p-pipe: 3.1.0 @@ -13646,28 +13631,21 @@ snapshots: p-reduce: 2.1.0 p-waterfall: 2.1.1 pacote: 21.0.1 - pify: 5.0.0 read-cmd-shim: 4.0.0 - resolve-from: 5.0.0 - rimraf: 6.1.3 semver: 7.7.2 - set-blocking: 2.0.0 signal-exit: 3.0.7 slash: 3.0.0 ssri: 12.0.0 string-width: 4.2.3 tar: 7.5.11 - temp-dir: 1.0.0 through: 2.3.8 tinyglobby: 0.2.12 typescript: 5.9.3 upath: 2.0.1 - uuid: 11.1.0 validate-npm-package-license: 3.0.4 validate-npm-package-name: 6.0.2 wide-align: 1.1.5 write-file-atomic: 5.0.1 - write-pkg: 4.0.0 yargs: 17.7.2 yargs-parser: 21.1.1 transitivePeerDependencies: @@ -13706,99 +13684,66 @@ snapshots: lightningcss-android-arm64@1.30.2: optional: true - lightningcss-android-arm64@1.31.1: - optional: true - lightningcss-android-arm64@1.32.0: optional: true lightningcss-darwin-arm64@1.30.2: optional: true - lightningcss-darwin-arm64@1.31.1: - optional: true - lightningcss-darwin-arm64@1.32.0: optional: true lightningcss-darwin-x64@1.30.2: optional: true - lightningcss-darwin-x64@1.31.1: - optional: true - lightningcss-darwin-x64@1.32.0: optional: true lightningcss-freebsd-x64@1.30.2: optional: true - lightningcss-freebsd-x64@1.31.1: - optional: true - lightningcss-freebsd-x64@1.32.0: optional: true lightningcss-linux-arm-gnueabihf@1.30.2: optional: true - lightningcss-linux-arm-gnueabihf@1.31.1: - optional: true - lightningcss-linux-arm-gnueabihf@1.32.0: optional: true lightningcss-linux-arm64-gnu@1.30.2: optional: true - lightningcss-linux-arm64-gnu@1.31.1: - optional: true - lightningcss-linux-arm64-gnu@1.32.0: optional: true lightningcss-linux-arm64-musl@1.30.2: optional: true - lightningcss-linux-arm64-musl@1.31.1: - optional: true - lightningcss-linux-arm64-musl@1.32.0: optional: true lightningcss-linux-x64-gnu@1.30.2: optional: true - lightningcss-linux-x64-gnu@1.31.1: - optional: true - lightningcss-linux-x64-gnu@1.32.0: optional: true lightningcss-linux-x64-musl@1.30.2: optional: true - lightningcss-linux-x64-musl@1.31.1: - optional: true - lightningcss-linux-x64-musl@1.32.0: optional: true lightningcss-win32-arm64-msvc@1.30.2: optional: true - lightningcss-win32-arm64-msvc@1.31.1: - optional: true - lightningcss-win32-arm64-msvc@1.32.0: optional: true lightningcss-win32-x64-msvc@1.30.2: optional: true - lightningcss-win32-x64-msvc@1.31.1: - optional: true - lightningcss-win32-x64-msvc@1.32.0: optional: true @@ -13818,22 +13763,6 @@ snapshots: lightningcss-win32-arm64-msvc: 1.30.2 lightningcss-win32-x64-msvc: 1.30.2 - lightningcss@1.31.1: - dependencies: - detect-libc: 2.1.2 - optionalDependencies: - lightningcss-android-arm64: 1.31.1 - lightningcss-darwin-arm64: 1.31.1 - lightningcss-darwin-x64: 1.31.1 - lightningcss-freebsd-x64: 1.31.1 - lightningcss-linux-arm-gnueabihf: 1.31.1 - lightningcss-linux-arm64-gnu: 1.31.1 - lightningcss-linux-arm64-musl: 1.31.1 - lightningcss-linux-x64-gnu: 1.31.1 - lightningcss-linux-x64-musl: 1.31.1 - lightningcss-win32-arm64-msvc: 1.31.1 - lightningcss-win32-x64-msvc: 1.31.1 - lightningcss@1.32.0: dependencies: detect-libc: 2.1.2 @@ -13939,7 +13868,7 @@ snapshots: lru-cache@10.4.3: {} - lru-cache@11.2.6: {} + lru-cache@11.2.7: {} lru-cache@6.0.0: dependencies: @@ -13959,11 +13888,6 @@ snapshots: "@babel/types": 7.29.0 source-map-js: 1.2.1 - make-dir@2.1.0: - dependencies: - pify: 4.0.1 - semver: 5.7.2 - make-dir@3.1.0: dependencies: semver: 6.3.1 @@ -14030,6 +13954,8 @@ snapshots: mdn-data@2.12.2: {} + mdn-data@2.27.1: {} + mdurl@2.0.0: {} media-typer@1.1.0: {} @@ -14203,14 +14129,6 @@ snapshots: ms@2.1.3: {} - multimatch@5.0.0: - dependencies: - "@types/minimatch": 3.0.5 - array-differ: 3.0.0 - array-union: 2.1.0 - arrify: 2.0.1 - minimatch: 3.1.4 - mute-stream@2.0.0: {} nanoid@3.3.11: {} @@ -14391,8 +14309,9 @@ snapshots: transitivePeerDependencies: - debug - nx@22.5.4(@swc/core@1.15.18): + nx@22.6.0(@swc/core@1.15.18): dependencies: + "@ltd/j-toml": 1.38.0 "@napi-rs/wasm-runtime": 0.2.4 "@yarnpkg/lockfile": 1.1.0 "@yarnpkg/parsers": 3.0.2 @@ -14430,16 +14349,16 @@ snapshots: yargs: 17.7.2 yargs-parser: 21.1.1 optionalDependencies: - "@nx/nx-darwin-arm64": 22.5.4 - "@nx/nx-darwin-x64": 22.5.4 - "@nx/nx-freebsd-x64": 22.5.4 - "@nx/nx-linux-arm-gnueabihf": 22.5.4 - "@nx/nx-linux-arm64-gnu": 22.5.4 - "@nx/nx-linux-arm64-musl": 22.5.4 - "@nx/nx-linux-x64-gnu": 22.5.4 - "@nx/nx-linux-x64-musl": 22.5.4 - "@nx/nx-win32-arm64-msvc": 22.5.4 - "@nx/nx-win32-x64-msvc": 22.5.4 + "@nx/nx-darwin-arm64": 22.6.0 + "@nx/nx-darwin-x64": 22.6.0 + "@nx/nx-freebsd-x64": 22.6.0 + "@nx/nx-linux-arm-gnueabihf": 22.6.0 + "@nx/nx-linux-arm64-gnu": 22.6.0 + "@nx/nx-linux-arm64-musl": 22.6.0 + "@nx/nx-linux-x64-gnu": 22.6.0 + "@nx/nx-linux-x64-musl": 22.6.0 + "@nx/nx-win32-arm64-msvc": 22.6.0 + "@nx/nx-win32-x64-msvc": 22.6.0 "@swc/core": 1.15.18 transitivePeerDependencies: - debug @@ -14702,7 +14621,7 @@ snapshots: path-scurry@2.0.2: dependencies: - lru-cache: 11.2.6 + lru-cache: 11.2.7 minipass: 7.1.3 path-to-regexp@8.3.0: {} @@ -14729,10 +14648,6 @@ snapshots: pify@3.0.0: {} - pify@4.0.1: {} - - pify@5.0.0: {} - pkg-dir@4.2.0: dependencies: find-up: 4.1.0 @@ -14769,7 +14684,7 @@ snapshots: dependencies: fast-diff: 1.3.0 - prettier-plugin-multiline-arrays@4.1.4(prettier@3.8.1): + prettier-plugin-multiline-arrays@4.1.5(prettier@3.8.1): dependencies: "@augment-vir/assert": 31.59.3 "@augment-vir/common": 31.59.3 @@ -14838,7 +14753,7 @@ snapshots: js-stringify: 1.0.2 pug-runtime: 3.0.1 - pug-code-gen@3.0.3: + pug-code-gen@3.0.4: dependencies: constantinople: 4.0.1 doctypes: 1.1.0 @@ -14888,9 +14803,9 @@ snapshots: pug-walk@2.0.0: {} - pug@3.0.3: + pug@3.0.4: dependencies: - pug-code-gen: 3.0.3 + pug-code-gen: 3.0.4 pug-filters: 4.0.0 pug-lexer: 5.0.1 pug-linker: 4.0.0 @@ -15004,7 +14919,7 @@ snapshots: rechoir@0.8.0: dependencies: - resolve: 1.22.8 + resolve: 1.22.10 redent@3.0.0: dependencies: @@ -15037,12 +14952,6 @@ snapshots: path-parse: 1.0.7 supports-preserve-symlinks-flag: 1.0.0 - resolve@1.22.8: - dependencies: - is-core-module: 2.15.1 - path-parse: 1.0.7 - supports-preserve-symlinks-flag: 1.0.0 - responselike@2.0.1: dependencies: lowercase-keys: 2.0.0 @@ -15075,26 +14984,57 @@ snapshots: sprintf-js: 1.1.3 optional: true - rolldown@1.0.0-rc.9: + rolldown@1.0.0-rc.10: + dependencies: + "@oxc-project/types": 0.120.0 + "@rolldown/pluginutils": 1.0.0-rc.10 + optionalDependencies: + "@rolldown/binding-android-arm64": 1.0.0-rc.10 + "@rolldown/binding-darwin-arm64": 1.0.0-rc.10 + "@rolldown/binding-darwin-x64": 1.0.0-rc.10 + "@rolldown/binding-freebsd-x64": 1.0.0-rc.10 + "@rolldown/binding-linux-arm-gnueabihf": 1.0.0-rc.10 + "@rolldown/binding-linux-arm64-gnu": 1.0.0-rc.10 + "@rolldown/binding-linux-arm64-musl": 1.0.0-rc.10 + "@rolldown/binding-linux-ppc64-gnu": 1.0.0-rc.10 + "@rolldown/binding-linux-s390x-gnu": 1.0.0-rc.10 + "@rolldown/binding-linux-x64-gnu": 1.0.0-rc.10 + "@rolldown/binding-linux-x64-musl": 1.0.0-rc.10 + "@rolldown/binding-openharmony-arm64": 1.0.0-rc.10 + "@rolldown/binding-wasm32-wasi": 1.0.0-rc.10 + "@rolldown/binding-win32-arm64-msvc": 1.0.0-rc.10 + "@rolldown/binding-win32-x64-msvc": 1.0.0-rc.10 + + rollup@4.59.0: dependencies: - "@oxc-project/types": 0.115.0 - "@rolldown/pluginutils": 1.0.0-rc.9 + "@types/estree": 1.0.8 optionalDependencies: - "@rolldown/binding-android-arm64": 1.0.0-rc.9 - "@rolldown/binding-darwin-arm64": 1.0.0-rc.9 - "@rolldown/binding-darwin-x64": 1.0.0-rc.9 - "@rolldown/binding-freebsd-x64": 1.0.0-rc.9 - "@rolldown/binding-linux-arm-gnueabihf": 1.0.0-rc.9 - "@rolldown/binding-linux-arm64-gnu": 1.0.0-rc.9 - "@rolldown/binding-linux-arm64-musl": 1.0.0-rc.9 - "@rolldown/binding-linux-ppc64-gnu": 1.0.0-rc.9 - "@rolldown/binding-linux-s390x-gnu": 1.0.0-rc.9 - "@rolldown/binding-linux-x64-gnu": 1.0.0-rc.9 - "@rolldown/binding-linux-x64-musl": 1.0.0-rc.9 - "@rolldown/binding-openharmony-arm64": 1.0.0-rc.9 - "@rolldown/binding-wasm32-wasi": 1.0.0-rc.9 - "@rolldown/binding-win32-arm64-msvc": 1.0.0-rc.9 - "@rolldown/binding-win32-x64-msvc": 1.0.0-rc.9 + "@rollup/rollup-android-arm-eabi": 4.59.0 + "@rollup/rollup-android-arm64": 4.59.0 + "@rollup/rollup-darwin-arm64": 4.59.0 + "@rollup/rollup-darwin-x64": 4.59.0 + "@rollup/rollup-freebsd-arm64": 4.59.0 + "@rollup/rollup-freebsd-x64": 4.59.0 + "@rollup/rollup-linux-arm-gnueabihf": 4.59.0 + "@rollup/rollup-linux-arm-musleabihf": 4.59.0 + "@rollup/rollup-linux-arm64-gnu": 4.59.0 + "@rollup/rollup-linux-arm64-musl": 4.59.0 + "@rollup/rollup-linux-loong64-gnu": 4.59.0 + "@rollup/rollup-linux-loong64-musl": 4.59.0 + "@rollup/rollup-linux-ppc64-gnu": 4.59.0 + "@rollup/rollup-linux-ppc64-musl": 4.59.0 + "@rollup/rollup-linux-riscv64-gnu": 4.59.0 + "@rollup/rollup-linux-riscv64-musl": 4.59.0 + "@rollup/rollup-linux-s390x-gnu": 4.59.0 + "@rollup/rollup-linux-x64-gnu": 4.59.0 + "@rollup/rollup-linux-x64-musl": 4.59.0 + "@rollup/rollup-openbsd-x64": 4.59.0 + "@rollup/rollup-openharmony-arm64": 4.59.0 + "@rollup/rollup-win32-arm64-msvc": 4.59.0 + "@rollup/rollup-win32-ia32-msvc": 4.59.0 + "@rollup/rollup-win32-x64-gnu": 4.59.0 + "@rollup/rollup-win32-x64-msvc": 4.59.0 + fsevents: 2.3.3 router@2.2.0: dependencies: @@ -15199,8 +15139,6 @@ snapshots: transitivePeerDependencies: - supports-color - set-blocking@2.0.0: {} - set-function-length@1.2.2: dependencies: define-data-property: 1.1.4 @@ -15306,10 +15244,6 @@ snapshots: ip-address: 10.1.0 smart-buffer: 4.2.0 - sort-keys@2.0.0: - dependencies: - is-plain-obj: 1.1.0 - source-map-js@1.2.1: {} source-map-support@0.5.21: @@ -15469,7 +15403,7 @@ snapshots: dependencies: "@swc/core": 1.15.18 "@swc/counter": 0.1.3 - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) symbol-tree@3.2.4: {} @@ -15513,15 +15447,13 @@ snapshots: minizlib: 3.1.0 yallist: 5.0.0 - temp-dir@1.0.0: {} - terser-webpack-plugin@5.4.0(@swc/core@1.15.18)(esbuild@0.27.2)(webpack@5.105.4): dependencies: "@jridgewell/trace-mapping": 0.3.31 jest-worker: 27.5.1 schema-utils: 4.3.3 terser: 5.46.0 - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) optionalDependencies: "@swc/core": 1.15.18 esbuild: 0.27.2 @@ -15596,7 +15528,7 @@ snapshots: dependencies: nopt: 1.0.10 - tough-cookie@6.0.0: + tough-cookie@6.0.1: dependencies: tldts: 7.0.19 @@ -15715,8 +15647,6 @@ snapshots: type-fest@0.18.1: {} - type-fest@0.4.1: {} - type-fest@0.6.0: {} type-fest@0.8.1: {} @@ -15775,12 +15705,12 @@ snapshots: typescript: 5.9.3 yaml: 2.8.1 - typescript-eslint@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3): + typescript-eslint@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3): dependencies: - "@typescript-eslint/eslint-plugin": 8.57.0(@typescript-eslint/parser@8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3))(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - "@typescript-eslint/parser": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) - "@typescript-eslint/typescript-estree": 8.57.0(typescript@5.9.3) - "@typescript-eslint/utils": 8.57.0(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/eslint-plugin": 8.57.1(@typescript-eslint/parser@8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3))(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/parser": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) + "@typescript-eslint/typescript-estree": 8.57.1(typescript@5.9.3) + "@typescript-eslint/utils": 8.57.1(eslint@10.0.3(jiti@2.6.1))(typescript@5.9.3) eslint: 10.0.3(jiti@2.6.1) typescript: 5.9.3 transitivePeerDependencies: @@ -15820,7 +15750,7 @@ snapshots: undici-types@7.22.0: {} - undici@7.22.0: {} + undici@7.24.3: {} unicorn-magic@0.3.0: {} @@ -15856,8 +15786,6 @@ snapshots: util-deprecate@1.0.2: {} - uuid@11.1.0: {} - v8-compile-cache-lib@3.0.1: {} validate-npm-package-license@3.0.4: @@ -15873,13 +15801,30 @@ snapshots: vary@1.1.2: {} - vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1): + vite@7.3.1(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1): + dependencies: + esbuild: 0.27.2 + fdir: 6.5.0(picomatch@4.0.3) + picomatch: 4.0.3 + postcss: 8.5.8 + rollup: 4.59.0 + tinyglobby: 0.2.15 + optionalDependencies: + "@types/node": 25.5.0 + fsevents: 2.3.3 + jiti: 2.6.1 + lightningcss: 1.32.0 + sass: 1.98.0 + stylus: 0.64.0 + terser: 5.46.0 + yaml: 2.8.1 + + vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1): dependencies: - "@oxc-project/runtime": 0.115.0 lightningcss: 1.32.0 picomatch: 4.0.3 postcss: 8.5.8 - rolldown: 1.0.0-rc.9 + rolldown: 1.0.0-rc.10 tinyglobby: 0.2.15 optionalDependencies: "@types/node": 25.5.0 @@ -15891,10 +15836,10 @@ snapshots: terser: 5.46.0 yaml: 2.8.1 - vitest@4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@28.1.0(canvas@3.2.1))(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)): + vitest@4.1.0(@types/node@25.5.0)(@vitest/ui@4.1.0)(jsdom@29.0.0(canvas@3.2.1))(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)): dependencies: "@vitest/expect": 4.1.0 - "@vitest/mocker": 4.1.0(vite@8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) + "@vitest/mocker": 4.1.0(vite@8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1)) "@vitest/pretty-format": 4.1.0 "@vitest/runner": 4.1.0 "@vitest/snapshot": 4.1.0 @@ -15911,12 +15856,12 @@ snapshots: tinyexec: 1.0.2 tinyglobby: 0.2.15 tinyrainbow: 3.0.3 - vite: 8.0.0(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) + vite: 8.0.1(@types/node@25.5.0)(esbuild@0.27.2)(jiti@2.6.1)(sass@1.98.0)(stylus@0.64.0)(terser@5.46.0)(yaml@2.8.1) why-is-node-running: 2.3.0 optionalDependencies: "@types/node": 25.5.0 "@vitest/ui": 4.1.0(vitest@4.1.0) - jsdom: 28.1.0(canvas@3.2.1) + jsdom: 29.0.0(canvas@3.2.1) transitivePeerDependencies: - msw @@ -15965,21 +15910,17 @@ snapshots: - bufferutil - utf-8-validate - webpack-cli@6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4): + webpack-cli@7.0.2(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4): dependencies: - "@discoveryjs/json-ext": 0.6.3 - "@webpack-cli/configtest": 3.0.1(webpack-cli@6.0.1)(webpack@5.105.4) - "@webpack-cli/info": 3.0.1(webpack-cli@6.0.1)(webpack@5.105.4) - "@webpack-cli/serve": 3.0.1(webpack-cli@6.0.1)(webpack@5.105.4) - colorette: 2.0.20 - commander: 12.1.0 - cross-spawn: 7.0.3 + "@discoveryjs/json-ext": 1.0.0 + commander: 14.0.3 + cross-spawn: 7.0.6 envinfo: 7.14.0 fastest-levenshtein: 1.0.16 import-local: 3.1.0 interpret: 3.1.1 rechoir: 0.8.0 - webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1) + webpack: 5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2) webpack-merge: 6.0.1 optionalDependencies: webpack-bundle-analyzer: 5.2.0 @@ -15992,7 +15933,7 @@ snapshots: webpack-sources@3.3.4: {} - webpack@5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@6.0.1): + webpack@5.105.4(@swc/core@1.15.18)(esbuild@0.27.2)(webpack-cli@7.0.2): dependencies: "@types/eslint-scope": 3.7.7 "@types/estree": 1.0.8 @@ -16020,7 +15961,7 @@ snapshots: watchpack: 2.5.1 webpack-sources: 3.3.4 optionalDependencies: - webpack-cli: 6.0.1(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) + webpack-cli: 7.0.2(webpack-bundle-analyzer@5.2.0)(webpack@5.105.4) transitivePeerDependencies: - "@swc/core" - esbuild @@ -16028,9 +15969,9 @@ snapshots: whatwg-mimetype@5.0.0: {} - whatwg-url@16.0.0: + whatwg-url@16.0.1: dependencies: - "@exodus/bytes": 1.11.0 + "@exodus/bytes": 1.15.0 tr46: 6.0.0 webidl-conversions: 8.0.1 transitivePeerDependencies: @@ -16086,8 +16027,8 @@ snapshots: with@7.0.2: dependencies: - "@babel/parser": 7.28.6 - "@babel/types": 7.28.6 + "@babel/parser": 7.29.0 + "@babel/types": 7.29.0 assert-never: 1.3.0 babel-walk: 3.0.0-canary-5 @@ -16119,12 +16060,6 @@ snapshots: wrappy@1.0.2: {} - write-file-atomic@2.4.3: - dependencies: - graceful-fs: 4.2.11 - imurmurhash: 0.1.4 - signal-exit: 3.0.7 - write-file-atomic@5.0.1: dependencies: imurmurhash: 0.1.4 @@ -16135,21 +16070,6 @@ snapshots: imurmurhash: 0.1.4 signal-exit: 4.1.0 - write-json-file@3.2.0: - dependencies: - detect-indent: 5.0.0 - graceful-fs: 4.2.11 - make-dir: 2.1.0 - pify: 4.0.1 - sort-keys: 2.0.0 - write-file-atomic: 2.4.3 - - write-pkg@4.0.0: - dependencies: - sort-keys: 2.0.0 - type-fest: 0.4.1 - write-json-file: 3.2.0 - ws@8.18.3: {} ws@8.19.0: {} diff --git a/shapes/arrow/CHANGELOG.md b/shapes/arrow/CHANGELOG.md index 8ca995df8de..1bb25988668 100644 --- a/shapes/arrow/CHANGELOG.md +++ b/shapes/arrow/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-arrow + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-arrow diff --git a/shapes/arrow/package.dist.json b/shapes/arrow/package.dist.json index 70bd1881308..631abc0f051 100644 --- a/shapes/arrow/package.dist.json +++ b/shapes/arrow/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-arrow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles arrow shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/arrow/package.json b/shapes/arrow/package.json index 16b2e932403..2ac980559a4 100644 --- a/shapes/arrow/package.json +++ b/shapes/arrow/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-arrow", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles arrow shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/cards/CHANGELOG.md b/shapes/cards/CHANGELOG.md index e4c80478dea..3c643e0c44a 100644 --- a/shapes/cards/CHANGELOG.md +++ b/shapes/cards/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-cards + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-cards diff --git a/shapes/cards/package.dist.json b/shapes/cards/package.dist.json index c84b6c8e9c7..97de6deddb4 100644 --- a/shapes/cards/package.dist.json +++ b/shapes/cards/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-cards", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles cards shape", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/path-utils": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/path-utils": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/cards/package.json b/shapes/cards/package.json index 33936cfc32d..9b423102942 100644 --- a/shapes/cards/package.json +++ b/shapes/cards/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-cards", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles cards shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/path-utils": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/path-utils": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/circle/CHANGELOG.md b/shapes/circle/CHANGELOG.md index b97541cbab9..5204503427d 100644 --- a/shapes/circle/CHANGELOG.md +++ b/shapes/circle/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-circle + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-circle diff --git a/shapes/circle/package.dist.json b/shapes/circle/package.dist.json index a6db8a8bb25..986f383e3c4 100644 --- a/shapes/circle/package.dist.json +++ b/shapes/circle/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-circle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles circle shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/circle/package.json b/shapes/circle/package.json index 29a65918862..618c0c4d837 100644 --- a/shapes/circle/package.json +++ b/shapes/circle/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-circle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles circle shape", "homepage": "https://particles.js.org", "scripts": { @@ -64,7 +64,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/cog/CHANGELOG.md b/shapes/cog/CHANGELOG.md index 8c16407ecb1..3a99107a372 100644 --- a/shapes/cog/CHANGELOG.md +++ b/shapes/cog/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-cog + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-cog diff --git a/shapes/cog/package.dist.json b/shapes/cog/package.dist.json index ad4fc9c4c3e..0180b11624d 100644 --- a/shapes/cog/package.dist.json +++ b/shapes/cog/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-cog", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles cog shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/cog/package.json b/shapes/cog/package.json index d8e1bc73a46..41ae9a2b79b 100644 --- a/shapes/cog/package.json +++ b/shapes/cog/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-cog", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles cog shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/emoji/CHANGELOG.md b/shapes/emoji/CHANGELOG.md index aff78f3c733..ad10c08dade 100644 --- a/shapes/emoji/CHANGELOG.md +++ b/shapes/emoji/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-emoji + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-emoji diff --git a/shapes/emoji/package.dist.json b/shapes/emoji/package.dist.json index 36f66fe1c27..1e301eb3c3b 100644 --- a/shapes/emoji/package.dist.json +++ b/shapes/emoji/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-emoji", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emoji shape", "homepage": "https://particles.js.org", "repository": { @@ -59,8 +59,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/emoji/package.json b/shapes/emoji/package.json index f1e5953872f..430c851cb60 100644 --- a/shapes/emoji/package.json +++ b/shapes/emoji/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-emoji", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles emoji shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,8 +67,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/heart/CHANGELOG.md b/shapes/heart/CHANGELOG.md index 06f670230bf..353cb664bf8 100644 --- a/shapes/heart/CHANGELOG.md +++ b/shapes/heart/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-heart + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-heart diff --git a/shapes/heart/package.dist.json b/shapes/heart/package.dist.json index 008289fc5a6..a8e1759793a 100644 --- a/shapes/heart/package.dist.json +++ b/shapes/heart/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-heart", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles heart shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/heart/package.json b/shapes/heart/package.json index 2cb68925019..187b9c1f059 100644 --- a/shapes/heart/package.json +++ b/shapes/heart/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-heart", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles heart shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/image/CHANGELOG.md b/shapes/image/CHANGELOG.md index 26a3219acdf..e0e6737b5d6 100644 --- a/shapes/image/CHANGELOG.md +++ b/shapes/image/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-image + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-image diff --git a/shapes/image/package.dist.json b/shapes/image/package.dist.json index eb2999f89c0..d7759c4fb3a 100644 --- a/shapes/image/package.dist.json +++ b/shapes/image/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-image", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles image shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/image/package.json b/shapes/image/package.json index a2aa83cf393..6a1126fda7f 100644 --- a/shapes/image/package.json +++ b/shapes/image/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-image", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles image shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,7 +67,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/infinity/CHANGELOG.md b/shapes/infinity/CHANGELOG.md index 07592371b17..f3de0e905bf 100644 --- a/shapes/infinity/CHANGELOG.md +++ b/shapes/infinity/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-infinity + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-infinity diff --git a/shapes/infinity/package.dist.json b/shapes/infinity/package.dist.json index 1cdb31ef964..b5e953792bc 100644 --- a/shapes/infinity/package.dist.json +++ b/shapes/infinity/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-infinity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles infinity shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/infinity/package.json b/shapes/infinity/package.json index 75cf2d6f4eb..e546e063672 100644 --- a/shapes/infinity/package.json +++ b/shapes/infinity/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-infinity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles infinity shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/line/CHANGELOG.md b/shapes/line/CHANGELOG.md index 2452710c63e..9cfb1db89f8 100644 --- a/shapes/line/CHANGELOG.md +++ b/shapes/line/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-line + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-line diff --git a/shapes/line/package.dist.json b/shapes/line/package.dist.json index 9fa4187630f..e0eab24480e 100644 --- a/shapes/line/package.dist.json +++ b/shapes/line/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-line", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles line shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/line/package.json b/shapes/line/package.json index e211a986df7..11431e439b9 100644 --- a/shapes/line/package.json +++ b/shapes/line/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-line", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles line shape", "homepage": "https://particles.js.org", "scripts": { @@ -72,7 +72,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "type": "module" } diff --git a/shapes/matrix/CHANGELOG.md b/shapes/matrix/CHANGELOG.md index e2314c0e7be..4b12d0ca040 100644 --- a/shapes/matrix/CHANGELOG.md +++ b/shapes/matrix/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-matrix + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-matrix diff --git a/shapes/matrix/package.dist.json b/shapes/matrix/package.dist.json index dd7752fc0e1..dddbed182b8 100644 --- a/shapes/matrix/package.dist.json +++ b/shapes/matrix/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-matrix", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles matrix shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/matrix/package.json b/shapes/matrix/package.json index d2e86d7ed95..b27c1fe38c4 100644 --- a/shapes/matrix/package.json +++ b/shapes/matrix/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-matrix", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles matrix shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/matrix/src/Utils.ts b/shapes/matrix/src/Utils.ts index 31416595c71..5ecf4e8f7bd 100644 --- a/shapes/matrix/src/Utils.ts +++ b/shapes/matrix/src/Utils.ts @@ -13,102 +13,94 @@ import type { IMatrixOptions } from "./IMatrixOptions.js"; * Pool of Matrix-style characters: katakana, digits, Latin letters */ export const matrixChars: string[] = [ - // ========================= // Katakana (base) - // ========================= - "ア", - "イ", - "ウ", - "エ", - "オ", - "カ", - "キ", - "ク", - "ケ", - "コ", - "サ", - "シ", - "ス", - "セ", - "ソ", - "タ", - "チ", - "ツ", - "テ", - "ト", - "ナ", - "ニ", - "ヌ", - "ネ", - "ノ", - "ハ", - "ヒ", - "フ", - "ヘ", - "ホ", - "マ", - "ミ", - "ム", - "メ", - "モ", - "ヤ", - "ユ", - "ヨ", - "ラ", - "リ", - "ル", - "レ", - "ロ", - "ワ", - "ヲ", - "ン", - // ========================= + "\u30A2", // ア + "\u30A4", // イ + "\u30A6", // ウ + "\u30A8", // エ + "\u30AA", // オ + "\u30AB", // カ + "\u30AD", // キ + "\u30AF", // ク + "\u30B1", // ケ + "\u30B3", // コ + "\u30B5", // サ + "\u30B7", // シ + "\u30B9", // ス + "\u30BB", // セ + "\u30BD", // ソ + "\u30BF", // タ + "\u30C1", // チ + "\u30C4", // ツ + "\u30C6", // テ + "\u30C8", // ト + "\u30CA", // ナ + "\u30CB", // ニ + "\u30CC", // ヌ + "\u30CD", // ネ + "\u30CE", // ノ + "\u30CF", // ハ + "\u30D2", // ヒ + "\u30D5", // フ + "\u30D8", // ヘ + "\u30DB", // ホ + "\u30DE", // マ + "\u30DF", // ミ + "\u30E0", // ム + "\u30E1", // メ + "\u30E2", // モ + "\u30E4", // ヤ + "\u30E6", // ユ + "\u30E8", // ヨ + "\u30E9", // ラ + "\u30EA", // リ + "\u30EB", // ル + "\u30EC", // レ + "\u30ED", // ロ + "\u30EF", // ワ + "\u30F2", // ヲ + "\u30F3", // ン // Katakana dakuten / handakuten - // ========================= - "ガ", - "ギ", - "グ", - "ゲ", - "ゴ", - "ザ", - "ジ", - "ズ", - "ゼ", - "ゾ", - "ダ", - "ヂ", - "ヅ", - "デ", - "ド", - "バ", - "ビ", - "ブ", - "ベ", - "ボ", - "パ", - "ピ", - "プ", - "ペ", - "ポ", - // ========================= + "\u30AC", // ガ + "\u30AE", // ギ + "\u30B0", // グ + "\u30B2", // ゲ + "\u30B4", // ゴ + "\u30B6", // ザ + "\u30B8", // ジ + "\u30BA", // ズ + "\u30BC", // ゼ + "\u30BE", // ゾ + "\u30C0", // ダ + "\u30C2", // ヂ + "\u30C5", // ヅ + "\u30C7", // デ + "\u30C9", // ド + "\u30D0", // バ + "\u30D3", // ビ + "\u30D6", // ブ + "\u30D9", // ベ + "\u30DC", // ボ + "\u30D1", // パ + "\u30D4", // ピ + "\u30D7", // プ + "\u30DA", // ペ + "\u30DD", // ポ // Small katakana - // ========================= - "ァ", - "ィ", - "ゥ", - "ェ", - "ォ", - "ャ", - "ュ", - "ョ", - "ッ", + "\u30A1", // ァ + "\u30A3", // ィ + "\u30A5", // ゥ + "\u30A7", // ェ + "\u30A9", // ォ + "\u30E3", // ャ + "\u30E5", // ュ + "\u30E7", // ョ + "\u30C3", // ッ // Long vowel mark - "ー", - // Extra katakana used visually - "ヴ", - // ========================= + "\u30FC", // ー + // Extra katakana + "\u30F4", // ヴ // Digits (ASCII) - // ========================= "0", "1", "2", @@ -119,22 +111,18 @@ export const matrixChars: string[] = [ "7", "8", "9", - // ========================= // Full-width digits - // ========================= - "０", - "１", - "２", - "３", - "４", - "５", - "６", - "７", - "８", - "９", - // ========================= + "\uFF10", // ０ + "\uFF11", // １ + "\uFF12", // ２ + "\uFF13", // ３ + "\uFF14", // ４ + "\uFF15", // ５ + "\uFF16", // ６ + "\uFF17", // ７ + "\uFF18", // ８ + "\uFF19", // ９ // Latin letters (uppercase) - // ========================= "A", "B", "C", @@ -161,29 +149,25 @@ export const matrixChars: string[] = [ "X", "Y", "Z", - // ========================= - // Kanji (seen / stylistically accurate) - // ========================= - "日", - "本", - "人", - "大", - "中", - "小", - "上", - "下", - "左", - "右", - "力", - "時", - "空", - "生", - "死", - "無", - "有", - // ========================= + // Kanji + "\u65E5", // 日 + "\u672C", // 本 + "\u4EBA", // 人 + "\u5927", // 大 + "\u4E2D", // 中 + "\u5C0F", // 小 + "\u4E0A", // 上 + "\u4E0B", // 下 + "\u5DE6", // 左 + "\u53F3", // 右 + "\u529B", // 力 + "\u6642", // 時 + "\u7A7A", // 空 + "\u751F", // 生 + "\u6B7B", // 死 + "\u7121", // 無 + "\u6709", // 有 // Symbols - // ========================= "!", "@", "#", diff --git a/shapes/path/CHANGELOG.md b/shapes/path/CHANGELOG.md index a733a91f238..81a87f05da0 100644 --- a/shapes/path/CHANGELOG.md +++ b/shapes/path/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-path + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-path diff --git a/shapes/path/package.dist.json b/shapes/path/package.dist.json index 2abf54805ba..3e19782819a 100644 --- a/shapes/path/package.dist.json +++ b/shapes/path/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-path", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles path shape", "homepage": "https://particles.js.org", "repository": { @@ -100,8 +100,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/path-utils": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/path-utils": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/path/package.json b/shapes/path/package.json index ebc45b4e3a8..54cc658b2bc 100644 --- a/shapes/path/package.json +++ b/shapes/path/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-path", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles path shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/path-utils": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/path-utils": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/polygon/CHANGELOG.md b/shapes/polygon/CHANGELOG.md index 9987880baf1..175614af716 100644 --- a/shapes/polygon/CHANGELOG.md +++ b/shapes/polygon/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-polygon + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-polygon diff --git a/shapes/polygon/package.dist.json b/shapes/polygon/package.dist.json index 2795339ddc2..cee0f202ba3 100644 --- a/shapes/polygon/package.dist.json +++ b/shapes/polygon/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/polygon/package.json b/shapes/polygon/package.json index b4b759caf3a..8b6bff3e634 100644 --- a/shapes/polygon/package.json +++ b/shapes/polygon/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles polygon shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,7 +67,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/rounded-polygon/CHANGELOG.md b/shapes/rounded-polygon/CHANGELOG.md index fac52da8ff1..e82a2697f88 100644 --- a/shapes/rounded-polygon/CHANGELOG.md +++ b/shapes/rounded-polygon/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-rounded-polygon + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-rounded-polygon diff --git a/shapes/rounded-polygon/package.dist.json b/shapes/rounded-polygon/package.dist.json index 8676c4febe1..e5ce46f681b 100644 --- a/shapes/rounded-polygon/package.dist.json +++ b/shapes/rounded-polygon/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-rounded-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles rounded polygon shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/rounded-polygon/package.json b/shapes/rounded-polygon/package.json index adb3a228442..aa9b4827721 100644 --- a/shapes/rounded-polygon/package.json +++ b/shapes/rounded-polygon/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-rounded-polygon", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles rounded polygon shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,7 +67,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/rounded-rect/CHANGELOG.md b/shapes/rounded-rect/CHANGELOG.md index d31f854c041..9c60f1f2387 100644 --- a/shapes/rounded-rect/CHANGELOG.md +++ b/shapes/rounded-rect/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-rounded-rect + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-rounded-rect diff --git a/shapes/rounded-rect/package.dist.json b/shapes/rounded-rect/package.dist.json index d1e2c22e8fa..4fd0af126ab 100644 --- a/shapes/rounded-rect/package.dist.json +++ b/shapes/rounded-rect/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-rounded-rect", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles rounded rect shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/rounded-rect/package.json b/shapes/rounded-rect/package.json index 6ab1de41d2d..3e6e9babe3a 100644 --- a/shapes/rounded-rect/package.json +++ b/shapes/rounded-rect/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-rounded-rect", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles rounded rect shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/spiral/CHANGELOG.md b/shapes/spiral/CHANGELOG.md index 776726079fe..7b6ddb61305 100644 --- a/shapes/spiral/CHANGELOG.md +++ b/shapes/spiral/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-spiral + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-spiral diff --git a/shapes/spiral/package.dist.json b/shapes/spiral/package.dist.json index cc399d69eda..7d5fc6f339f 100644 --- a/shapes/spiral/package.dist.json +++ b/shapes/spiral/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-spiral", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles spiral shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/spiral/package.json b/shapes/spiral/package.json index 7a4eabd0f20..5629387e1ab 100644 --- a/shapes/spiral/package.json +++ b/shapes/spiral/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-spiral", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles spiral shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/square/CHANGELOG.md b/shapes/square/CHANGELOG.md index 8fb9b4273d5..010d6b2a488 100644 --- a/shapes/square/CHANGELOG.md +++ b/shapes/square/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-square + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-square diff --git a/shapes/square/package.dist.json b/shapes/square/package.dist.json index fcffe0a79a7..752da447128 100644 --- a/shapes/square/package.dist.json +++ b/shapes/square/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-square", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles square shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/square/package.json b/shapes/square/package.json index 076fa738c92..196cde13b61 100644 --- a/shapes/square/package.json +++ b/shapes/square/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-square", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles square shape", "homepage": "https://particles.js.org", "scripts": { @@ -72,7 +72,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "type": "module" } diff --git a/shapes/squircle/CHANGELOG.md b/shapes/squircle/CHANGELOG.md index 1c1ef61dd7c..b06147d36fa 100644 --- a/shapes/squircle/CHANGELOG.md +++ b/shapes/squircle/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-squircle + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) ### Bug Fixes diff --git a/shapes/squircle/package.dist.json b/shapes/squircle/package.dist.json index 053223dd62e..bff95dc8227 100644 --- a/shapes/squircle/package.dist.json +++ b/shapes/squircle/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-squircle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles squircle shape", "homepage": "https://particles.js.org", "repository": { @@ -100,7 +100,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/squircle/package.json b/shapes/squircle/package.json index 6f2eafb835d..d326471f4d1 100644 --- a/shapes/squircle/package.json +++ b/shapes/squircle/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-squircle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles squircle shape", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/star/CHANGELOG.md b/shapes/star/CHANGELOG.md index 476d0046fec..13fc910710b 100644 --- a/shapes/star/CHANGELOG.md +++ b/shapes/star/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-star + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-star diff --git a/shapes/star/package.dist.json b/shapes/star/package.dist.json index ff491c1ce9b..5f3720c32d0 100644 --- a/shapes/star/package.dist.json +++ b/shapes/star/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-star", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles star shape", "homepage": "https://particles.js.org", "repository": { @@ -59,7 +59,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/star/package.json b/shapes/star/package.json index 9e1826daf56..ed97a731ac0 100644 --- a/shapes/star/package.json +++ b/shapes/star/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-star", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles star shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,7 +67,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/shapes/text/CHANGELOG.md b/shapes/text/CHANGELOG.md index 26b2831e6ae..7725f087ed0 100644 --- a/shapes/text/CHANGELOG.md +++ b/shapes/text/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/shape-text + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/shape-text diff --git a/shapes/text/package.dist.json b/shapes/text/package.dist.json index 822b03d72ac..9839b0b3e18 100644 --- a/shapes/text/package.dist.json +++ b/shapes/text/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-text", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles text shape", "homepage": "https://particles.js.org", "repository": { @@ -59,8 +59,8 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "4.0.0-alpha.28", - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/canvas-utils": "4.0.0-beta.0", + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/shapes/text/package.json b/shapes/text/package.json index 12f17c83c7c..3df917beb0e 100644 --- a/shapes/text/package.json +++ b/shapes/text/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/shape-text", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles text shape", "homepage": "https://particles.js.org", "scripts": { @@ -67,8 +67,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/canvas-utils": "workspace:4.0.0-alpha.28", - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/canvas-utils": "workspace:4.0.0-beta.0", + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/destroy/CHANGELOG.md b/updaters/destroy/CHANGELOG.md index 3634d1ec961..de5d52fe043 100644 --- a/updaters/destroy/CHANGELOG.md +++ b/updaters/destroy/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-destroy + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-destroy diff --git a/updaters/destroy/package.dist.json b/updaters/destroy/package.dist.json index 7b1c8f7aafd..0de20f9cf4f 100644 --- a/updaters/destroy/package.dist.json +++ b/updaters/destroy/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-destroy", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles destroy updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/destroy/package.json b/updaters/destroy/package.json index 7752bda176e..1ac0c1a6c2b 100644 --- a/updaters/destroy/package.json +++ b/updaters/destroy/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-destroy", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles destroy updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/fillColor/CHANGELOG.md b/updaters/fillColor/CHANGELOG.md index aeea92738ad..16a67801449 100644 --- a/updaters/fillColor/CHANGELOG.md +++ b/updaters/fillColor/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-fill-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-fill-color diff --git a/updaters/fillColor/package.dist.json b/updaters/fillColor/package.dist.json index 7089c66276e..12aaab5d244 100644 --- a/updaters/fillColor/package.dist.json +++ b/updaters/fillColor/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-fill-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles fill color updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/fillColor/package.json b/updaters/fillColor/package.json index 426a02ec503..609ceb07520 100644 --- a/updaters/fillColor/package.json +++ b/updaters/fillColor/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-fill-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles fill color updater", "homepage": "https://particles.js.org", "scripts": { @@ -97,7 +97,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "type": "module" } diff --git a/updaters/gradient/CHANGELOG.md b/updaters/gradient/CHANGELOG.md index f10a4d5e8bd..39b3895ed04 100644 --- a/updaters/gradient/CHANGELOG.md +++ b/updaters/gradient/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-gradient + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-gradient diff --git a/updaters/gradient/package.dist.json b/updaters/gradient/package.dist.json index 84800522645..66e48c77e2d 100644 --- a/updaters/gradient/package.dist.json +++ b/updaters/gradient/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-gradient", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles gradient updater", "homepage": "https://particles.js.org", "repository": { @@ -101,7 +101,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/gradient/package.json b/updaters/gradient/package.json index 761588ca381..aef5644ef3b 100644 --- a/updaters/gradient/package.json +++ b/updaters/gradient/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-gradient", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles gradient updater", "homepage": "https://particles.js.org", "scripts": { @@ -109,7 +109,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/life/CHANGELOG.md b/updaters/life/CHANGELOG.md index 237c9f6ca32..5307e2d3cdc 100644 --- a/updaters/life/CHANGELOG.md +++ b/updaters/life/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-life + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-life diff --git a/updaters/life/package.dist.json b/updaters/life/package.dist.json index 37ab8035c18..78558bdeb92 100644 --- a/updaters/life/package.dist.json +++ b/updaters/life/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-life", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles life updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/life/package.json b/updaters/life/package.json index 1b378e2a53b..247a37e902a 100644 --- a/updaters/life/package.json +++ b/updaters/life/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-life", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles life updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/opacity/CHANGELOG.md b/updaters/opacity/CHANGELOG.md index 1865d21225b..32dd4145a26 100644 --- a/updaters/opacity/CHANGELOG.md +++ b/updaters/opacity/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-opacity + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-opacity diff --git a/updaters/opacity/package.dist.json b/updaters/opacity/package.dist.json index fc8d0ff0e07..810a661b190 100644 --- a/updaters/opacity/package.dist.json +++ b/updaters/opacity/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-opacity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles opacity updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/opacity/package.json b/updaters/opacity/package.json index 69026a2d4ef..d6f6078574d 100644 --- a/updaters/opacity/package.json +++ b/updaters/opacity/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-opacity", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles opacity updater", "homepage": "https://particles.js.org", "scripts": { @@ -92,7 +92,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/orbit/CHANGELOG.md b/updaters/orbit/CHANGELOG.md index 8037d629f80..1b84d1f5df9 100644 --- a/updaters/orbit/CHANGELOG.md +++ b/updaters/orbit/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-orbit + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-orbit diff --git a/updaters/orbit/package.dist.json b/updaters/orbit/package.dist.json index 472e5de1e72..9716ec99189 100644 --- a/updaters/orbit/package.dist.json +++ b/updaters/orbit/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-orbit", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles orbit updater", "homepage": "https://particles.js.org", "repository": { @@ -101,7 +101,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/orbit/package.json b/updaters/orbit/package.json index 73681d4ba41..ec9d3f7fe76 100644 --- a/updaters/orbit/package.json +++ b/updaters/orbit/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-orbit", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles orbit updater", "homepage": "https://particles.js.org", "scripts": { @@ -109,7 +109,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/outModes/CHANGELOG.md b/updaters/outModes/CHANGELOG.md index 13a3d460ffb..96f52e1f457 100644 --- a/updaters/outModes/CHANGELOG.md +++ b/updaters/outModes/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-out-modes + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-out-modes diff --git a/updaters/outModes/package.dist.json b/updaters/outModes/package.dist.json index a0e02a44048..aed6f9b0b5a 100644 --- a/updaters/outModes/package.dist.json +++ b/updaters/outModes/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-out-modes", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles out modes updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/outModes/package.json b/updaters/outModes/package.json index c01ddad3cef..dd0115802bd 100644 --- a/updaters/outModes/package.json +++ b/updaters/outModes/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-out-modes", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles out modes updater", "homepage": "https://particles.js.org", "scripts": { @@ -92,7 +92,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/roll/CHANGELOG.md b/updaters/roll/CHANGELOG.md index c08738f30f9..112470cb14d 100644 --- a/updaters/roll/CHANGELOG.md +++ b/updaters/roll/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-roll + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-roll diff --git a/updaters/roll/package.dist.json b/updaters/roll/package.dist.json index 1d883588f6b..9ba28b011c1 100644 --- a/updaters/roll/package.dist.json +++ b/updaters/roll/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-roll", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles roll updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/roll/package.json b/updaters/roll/package.json index 0ab16eb609b..adff8e7c0cf 100644 --- a/updaters/roll/package.json +++ b/updaters/roll/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-roll", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles roll updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/rotate/CHANGELOG.md b/updaters/rotate/CHANGELOG.md index b209f328713..5b75dd3852c 100644 --- a/updaters/rotate/CHANGELOG.md +++ b/updaters/rotate/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-rotate + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-rotate diff --git a/updaters/rotate/package.dist.json b/updaters/rotate/package.dist.json index 93f32f9b4c1..ba3808de7f1 100644 --- a/updaters/rotate/package.dist.json +++ b/updaters/rotate/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-rotate", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles rotate updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/rotate/package.json b/updaters/rotate/package.json index b6e0533a5a5..8bfb330e38b 100644 --- a/updaters/rotate/package.json +++ b/updaters/rotate/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-rotate", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles rotate updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/size/CHANGELOG.md b/updaters/size/CHANGELOG.md index 0ea7199c594..66ab6d530bd 100644 --- a/updaters/size/CHANGELOG.md +++ b/updaters/size/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-size + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-size diff --git a/updaters/size/package.dist.json b/updaters/size/package.dist.json index b54e97f539a..66f0db26249 100644 --- a/updaters/size/package.dist.json +++ b/updaters/size/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-size", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles size updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/size/package.json b/updaters/size/package.json index 7107a1fd7fd..7f547ffece8 100644 --- a/updaters/size/package.json +++ b/updaters/size/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-size", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles size updater", "homepage": "https://particles.js.org", "scripts": { @@ -92,7 +92,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/strokeColor/CHANGELOG.md b/updaters/strokeColor/CHANGELOG.md index 5e606156cb3..d5d0182d6de 100644 --- a/updaters/strokeColor/CHANGELOG.md +++ b/updaters/strokeColor/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-stroke-color + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-stroke-color diff --git a/updaters/strokeColor/package.dist.json b/updaters/strokeColor/package.dist.json index 9a1db96b5b1..b72aac092ec 100644 --- a/updaters/strokeColor/package.dist.json +++ b/updaters/strokeColor/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-stroke-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles stroke color updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/strokeColor/package.json b/updaters/strokeColor/package.json index f39416bbeab..9db39c7cf27 100644 --- a/updaters/strokeColor/package.json +++ b/updaters/strokeColor/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-stroke-color", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles stroke color updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/tilt/CHANGELOG.md b/updaters/tilt/CHANGELOG.md index d6f1ca49251..fdc6cb6145a 100644 --- a/updaters/tilt/CHANGELOG.md +++ b/updaters/tilt/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-tilt + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-tilt diff --git a/updaters/tilt/package.dist.json b/updaters/tilt/package.dist.json index cf08af26ac9..7ebb99104b1 100644 --- a/updaters/tilt/package.dist.json +++ b/updaters/tilt/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-tilt", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles tilt updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/tilt/package.json b/updaters/tilt/package.json index 6357d88e5b8..04f1299eb41 100644 --- a/updaters/tilt/package.json +++ b/updaters/tilt/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-tilt", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles tilt updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/twinkle/CHANGELOG.md b/updaters/twinkle/CHANGELOG.md index 8082c6ba7e3..95e9f6788d9 100644 --- a/updaters/twinkle/CHANGELOG.md +++ b/updaters/twinkle/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-twinkle + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-twinkle diff --git a/updaters/twinkle/package.dist.json b/updaters/twinkle/package.dist.json index 5a997e37757..7506099a442 100644 --- a/updaters/twinkle/package.dist.json +++ b/updaters/twinkle/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-twinkle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles twinkle updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/twinkle/package.json b/updaters/twinkle/package.json index 0296847e62e..fb335cecd46 100644 --- a/updaters/twinkle/package.json +++ b/updaters/twinkle/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-twinkle", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles twinkle updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/updaters/wobble/CHANGELOG.md b/updaters/wobble/CHANGELOG.md index 64cecc496b4..a494db534c7 100644 --- a/updaters/wobble/CHANGELOG.md +++ b/updaters/wobble/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/updater-wobble + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/updater-wobble diff --git a/updaters/wobble/package.dist.json b/updaters/wobble/package.dist.json index b2a6f59cd9a..3724b9bdb67 100644 --- a/updaters/wobble/package.dist.json +++ b/updaters/wobble/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-wobble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles wobble updater", "homepage": "https://particles.js.org", "repository": { @@ -87,7 +87,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/updaters/wobble/package.json b/updaters/wobble/package.json index 99ace34d8ff..b2155d153a2 100644 --- a/updaters/wobble/package.json +++ b/updaters/wobble/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/updater-wobble", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles particles wobble updater", "homepage": "https://particles.js.org", "scripts": { @@ -95,7 +95,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/canvasUtils/CHANGELOG.md b/utils/canvasUtils/CHANGELOG.md index d1d8cae394d..fa7efd490de 100644 --- a/utils/canvasUtils/CHANGELOG.md +++ b/utils/canvasUtils/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/canvas-utils + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/canvas-utils diff --git a/utils/canvasUtils/package.dist.json b/utils/canvasUtils/package.dist.json index feb16b8faba..947679bb182 100644 --- a/utils/canvasUtils/package.dist.json +++ b/utils/canvasUtils/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/canvas-utils", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles canvas utils library", "homepage": "https://particles.js.org", "repository": { @@ -103,7 +103,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "type": "module" } diff --git a/utils/canvasUtils/package.json b/utils/canvasUtils/package.json index c5f65f274d0..c0fe3f969c6 100644 --- a/utils/canvasUtils/package.json +++ b/utils/canvasUtils/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/canvas-utils", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles canvas utils path", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/configs/CHANGELOG.md b/utils/configs/CHANGELOG.md index f1490185e6b..aeebed1e2be 100644 --- a/utils/configs/CHANGELOG.md +++ b/utils/configs/CHANGELOG.md @@ -3,6 +3,13 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +### Features + +- added drag & drop interaction external (mouse click) ([87ac189](https://github.com/tsparticles/tsparticles/commit/87ac189240ded4d3055d145fa7453bc9c17b1d82)) +- added momentum option to drag & drop interactor ([12d3696](https://github.com/tsparticles/tsparticles/commit/12d3696376d98c9000ff73cd518b1eae268a59b4)) + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/configs diff --git a/utils/configs/package.dist.json b/utils/configs/package.dist.json index 008f6561938..08c31e456f3 100644 --- a/utils/configs/package.dist.json +++ b/utils/configs/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/configs", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles demo configurations", "homepage": "https://particles.js.org", "repository": { @@ -99,7 +99,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "publishConfig": { "access": "public" diff --git a/utils/configs/package.json b/utils/configs/package.json index f7016f78fcf..9b6f562f555 100644 --- a/utils/configs/package.json +++ b/utils/configs/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/configs", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "homepage": "https://particles.js.org", "scripts": { "build": "tsparticles-cli build", @@ -106,7 +106,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/configs/src/m/index.ts b/utils/configs/src/m/index.ts index 9caeae41531..d23125a5cb2 100644 --- a/utils/configs/src/m/index.ts +++ b/utils/configs/src/m/index.ts @@ -4,6 +4,8 @@ import motionDisable from "./motionDisable.js"; import motionReduce from "./motionReduce.js"; import mouseAttract from "./mouseAttract.js"; import mouseBounce from "./mouseBounce.js"; +import mouseDrag from "./mouseDrag.js"; +import mouseDragMomentum from "./mouseDragMomentum.js"; import mouseFollow from "./mouseFollow.js"; import mouseParticle from "./mouseParticle.js"; import mouseParticle2 from "./mouseParticle2.js"; @@ -23,6 +25,8 @@ export default { motionReduce, mouseAttract, mouseBounce, + mouseDrag, + mouseDragMomentum, mouseFollow, mouseParticle, mouseParticle2, diff --git a/utils/configs/src/m/mouseDrag.ts b/utils/configs/src/m/mouseDrag.ts new file mode 100644 index 00000000000..cf5bfcf54d3 --- /dev/null +++ b/utils/configs/src/m/mouseDrag.ts @@ -0,0 +1,51 @@ +import type { ISourceOptions } from "@tsparticles/engine"; + +const options: ISourceOptions = { + key: "mouseDrag", + name: "Mouse Drag", + particles: { + number: { + value: 80, + density: { + enable: true, + }, + }, + fill: { + color: { + value: "#ff0000", + animation: { + enable: true, + speed: 20, + sync: true, + }, + }, + enable: true, + }, + shape: { + type: "circle", + }, + size: { + value: { + min: 20, + max: 30, + }, + }, + move: { + enable: true, + speed: 6, + }, + }, + interactivity: { + events: { + onClick: { + enable: true, + mode: "drag", + }, + }, + }, + background: { + color: "#000000", + }, +}; + +export default options; diff --git a/utils/configs/src/m/mouseDragMomentum.ts b/utils/configs/src/m/mouseDragMomentum.ts new file mode 100644 index 00000000000..579b3f0577f --- /dev/null +++ b/utils/configs/src/m/mouseDragMomentum.ts @@ -0,0 +1,56 @@ +import type { ISourceOptions } from "@tsparticles/engine"; + +const options: ISourceOptions = { + key: "mouseDragMomentum", + name: "Mouse Drag Momentum", + particles: { + number: { + value: 80, + density: { + enable: true, + }, + }, + fill: { + color: { + value: "#ff0000", + animation: { + enable: true, + speed: 20, + sync: true, + }, + }, + enable: true, + }, + shape: { + type: "circle", + }, + size: { + value: { + min: 20, + max: 30, + }, + }, + move: { + enable: true, + speed: 6, + }, + }, + interactivity: { + events: { + onClick: { + enable: true, + mode: "drag", + }, + }, + modes: { + drag: { + preserveMomentum: true, + }, + }, + }, + background: { + color: "#000000", + }, +}; + +export default options; diff --git a/utils/fractalNoise/CHANGELOG.md b/utils/fractalNoise/CHANGELOG.md index 5f74e1abd2a..f030692e93a 100644 --- a/utils/fractalNoise/CHANGELOG.md +++ b/utils/fractalNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/fractal-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/fractal-noise diff --git a/utils/fractalNoise/package.dist.json b/utils/fractalNoise/package.dist.json index 7b5ae76694a..ff314157499 100644 --- a/utils/fractalNoise/package.dist.json +++ b/utils/fractalNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/fractal-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles fractal noise library", "homepage": "https://particles.js.org", "repository": { @@ -92,7 +92,7 @@ "module": "esm/index.js", "types": "types/index.d.ts", "dependencies": { - "@tsparticles/smooth-value-noise": "4.0.0-alpha.28" + "@tsparticles/smooth-value-noise": "4.0.0-beta.0" }, "exports": { ".": { diff --git a/utils/fractalNoise/package.json b/utils/fractalNoise/package.json index 8b3856e4b52..d59bc95932f 100644 --- a/utils/fractalNoise/package.json +++ b/utils/fractalNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/fractal-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles fractal noise path", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/smooth-value-noise": "workspace:4.0.0-alpha.28" + "@tsparticles/smooth-value-noise": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/noiseField/CHANGELOG.md b/utils/noiseField/CHANGELOG.md index 85ad2ecad9c..5e5bab8317e 100644 --- a/utils/noiseField/CHANGELOG.md +++ b/utils/noiseField/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/noise-field + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/noise-field diff --git a/utils/noiseField/package.dist.json b/utils/noiseField/package.dist.json index 3c17766af9b..67d02f4634b 100644 --- a/utils/noiseField/package.dist.json +++ b/utils/noiseField/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/noise-field", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles noise field library", "homepage": "https://particles.js.org", "repository": { @@ -92,8 +92,8 @@ "module": "esm/index.js", "types": "types/index.d.ts", "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28", - "@tsparticles/plugin-move": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0", + "@tsparticles/plugin-move": "4.0.0-beta.0" }, "exports": { ".": { diff --git a/utils/noiseField/package.json b/utils/noiseField/package.json index c7a7d9cb325..668a830cc66 100644 --- a/utils/noiseField/package.json +++ b/utils/noiseField/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/noise-field", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles noise field library", "homepage": "https://particles.js.org", "scripts": { @@ -108,8 +108,8 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-move": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-move": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/pathUtils/CHANGELOG.md b/utils/pathUtils/CHANGELOG.md index d2808fc869e..af3593dca6b 100644 --- a/utils/pathUtils/CHANGELOG.md +++ b/utils/pathUtils/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/path-utils + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/path-utils diff --git a/utils/pathUtils/package.dist.json b/utils/pathUtils/package.dist.json index ad0ee3818a4..813c88caebd 100644 --- a/utils/pathUtils/package.dist.json +++ b/utils/pathUtils/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-utils", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles path utils library", "homepage": "https://particles.js.org", "repository": { @@ -103,7 +103,7 @@ "./package.json": "./package.json" }, "dependencies": { - "@tsparticles/engine": "4.0.0-alpha.28" + "@tsparticles/engine": "4.0.0-beta.0" }, "type": "module" } diff --git a/utils/pathUtils/package.json b/utils/pathUtils/package.json index 23a2dfbfea6..cf62ece0bd0 100644 --- a/utils/pathUtils/package.json +++ b/utils/pathUtils/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/path-utils", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles path utils path", "homepage": "https://particles.js.org", "scripts": { @@ -108,7 +108,7 @@ "./package.json": "./dist/package.json" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0" }, "publishConfig": { "access": "public", diff --git a/utils/perlinNoise/CHANGELOG.md b/utils/perlinNoise/CHANGELOG.md index 1e04ade2879..5443ff433ba 100644 --- a/utils/perlinNoise/CHANGELOG.md +++ b/utils/perlinNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/perlin-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/perlin-noise diff --git a/utils/perlinNoise/package.dist.json b/utils/perlinNoise/package.dist.json index 43b490f5fef..056870412ae 100644 --- a/utils/perlinNoise/package.dist.json +++ b/utils/perlinNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/perlin-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles perlin noise library", "homepage": "https://particles.js.org", "repository": { diff --git a/utils/perlinNoise/package.json b/utils/perlinNoise/package.json index ea81dc07bea..1a686072106 100644 --- a/utils/perlinNoise/package.json +++ b/utils/perlinNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/perlin-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles perlin noise path", "homepage": "https://particles.js.org", "scripts": { diff --git a/utils/simplexNoise/CHANGELOG.md b/utils/simplexNoise/CHANGELOG.md index 119d7c56a6b..b9a8e1e8fd5 100644 --- a/utils/simplexNoise/CHANGELOG.md +++ b/utils/simplexNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/simplex-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/simplex-noise diff --git a/utils/simplexNoise/package.dist.json b/utils/simplexNoise/package.dist.json index fe38956673b..993ac20e9ac 100644 --- a/utils/simplexNoise/package.dist.json +++ b/utils/simplexNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/simplex-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles simplex noise library", "homepage": "https://particles.js.org", "repository": { diff --git a/utils/simplexNoise/package.json b/utils/simplexNoise/package.json index f01c0953212..5c4352a3981 100644 --- a/utils/simplexNoise/package.json +++ b/utils/simplexNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/simplex-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles simplex noise library", "homepage": "https://particles.js.org", "scripts": { diff --git a/utils/smoothValueNoise/CHANGELOG.md b/utils/smoothValueNoise/CHANGELOG.md index e0ad362d398..fb192bb3b2d 100644 --- a/utils/smoothValueNoise/CHANGELOG.md +++ b/utils/smoothValueNoise/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/smooth-value-noise + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/smooth-value-noise diff --git a/utils/smoothValueNoise/package.dist.json b/utils/smoothValueNoise/package.dist.json index 92369e6d893..c79d48fd141 100644 --- a/utils/smoothValueNoise/package.dist.json +++ b/utils/smoothValueNoise/package.dist.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/smooth-value-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles smooth value noise library", "homepage": "https://particles.js.org", "repository": { diff --git a/utils/smoothValueNoise/package.json b/utils/smoothValueNoise/package.json index 6bd39412b54..0641b6e1ead 100644 --- a/utils/smoothValueNoise/package.json +++ b/utils/smoothValueNoise/package.json @@ -1,6 +1,6 @@ { "name": "@tsparticles/smooth-value-noise", - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "description": "tsParticles smooth value noise path", "homepage": "https://particles.js.org", "scripts": { diff --git a/utils/tests/CHANGELOG.md b/utils/tests/CHANGELOG.md index ce65e71ba39..99c683f9e82 100644 --- a/utils/tests/CHANGELOG.md +++ b/utils/tests/CHANGELOG.md @@ -3,6 +3,10 @@ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. +# [4.0.0-beta.0](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.28...v4.0.0-beta.0) (2026-03-19) + +**Note:** Version bump only for package @tsparticles/tests + # [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15) **Note:** Version bump only for package @tsparticles/tests diff --git a/utils/tests/package.json b/utils/tests/package.json index ad2e113bbb3..f237cc8aaf2 100644 --- a/utils/tests/package.json +++ b/utils/tests/package.json @@ -1,7 +1,7 @@ { "name": "@tsparticles/tests", "private": true, - "version": "4.0.0-alpha.28", + "version": "4.0.0-beta.0", "scripts": { "prettify:ci": "prettier --check ./src", "prettify": "prettier --write ./src", @@ -16,11 +16,11 @@ "test:ci": "NODE_ENV=test vitest run --maxConcurrency=2" }, "dependencies": { - "@tsparticles/engine": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hex-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsl-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-hsv-color": "workspace:4.0.0-alpha.28", - "@tsparticles/plugin-rgb-color": "workspace:4.0.0-alpha.28" + "@tsparticles/engine": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hex-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsl-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-hsv-color": "workspace:4.0.0-beta.0", + "@tsparticles/plugin-rgb-color": "workspace:4.0.0-beta.0" }, "type": "module" }