@tsparticles/nextjs 4.0.0-beta.12

package/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.

package/README.md

@@ -0,0 +1,80 @@
+[![banner](https://particles.js.org/images/banner3.png)](https://particles.js.org)
+
+# @tsparticles/nextjs
+
+Next.js integration wrapper for [@tsparticles/react](https://www.npmjs.com/package/@tsparticles/react).
+
+## Why this package
+
+- Provides Next.js-first exports (`NextParticlesProvider`, `NextParticles`).
+- Handles client-only rendering for particles via dynamic import.
+- Keeps the one-time async init flow centered on the provider.
+
+## Installation
+
+```bash
+pnpm add @tsparticles/nextjs @tsparticles/react @tsparticles/engine
+```
+
+or
+
+```bash
+npm install @tsparticles/nextjs @tsparticles/react @tsparticles/engine
+```
+
+or
+
+```bash
+yarn add @tsparticles/nextjs @tsparticles/react @tsparticles/engine
+```
+
+## Usage (App Router)
+
+```tsx
+"use client";
+
+import { NextParticles, NextParticlesProvider } from "@tsparticles/nextjs";
+import type { Engine } from "@tsparticles/engine";
+
+const init = async (engine: Engine): Promise<void> => {
+  const [{ loadSlim }, { loadThemesPlugin }] = await Promise.all([
+    import("@tsparticles/slim"),
+    import("@tsparticles/plugin-themes"),
+  ]);
+
+  await Promise.all([loadSlim(engine), loadThemesPlugin(engine)]);
+};
+
+export default function Page() {
+  return (
+    <NextParticlesProvider init={init}>
+      <NextParticles id="tsparticles" options={{ fullScreen: { zIndex: -1 } }} />
+    </NextParticlesProvider>
+  );
+}
+```
+
+## Usage (Pages Router)
+
+```tsx
+import type { AppProps } from "next/app";
+import { NextParticlesProvider } from "@tsparticles/nextjs";
+import type { Engine } from "@tsparticles/engine";
+
+const init = async (engine: Engine): Promise<void> => {
+  const [{ loadSlim }, { loadThemesPlugin }] = await Promise.all([
+    import("@tsparticles/slim"),
+    import("@tsparticles/plugin-themes"),
+  ]);
+
+  await Promise.all([loadSlim(engine), loadThemesPlugin(engine)]);
+};
+
+export default function App({ Component, pageProps }: AppProps) {
+  return (
+    <NextParticlesProvider init={init}>
+      <Component {...pageProps} />
+    </NextParticlesProvider>
+  );
+}
+```

package/dist/index.js

@@ -0,0 +1,15 @@
+"use client";
+import e from "next/dynamic";
+import { ParticlesProvider as t } from "@tsparticles/react";
+import { jsx as n } from "react/jsx-runtime";
+//#region lib/index.tsx
+var r = e(() => import("@tsparticles/react").then((e) => e.Particles), { ssr: !1 });
+function i({ children: e, init: r }) {
+	return /* @__PURE__ */ n(t, {
+		init: r,
+		children: e
+	});
+}
+var a = r;
+//#endregion
+export { a as NextParticles, i as NextParticlesProvider };

package/dist/lib/index.d.ts

@@ -0,0 +1,8 @@
+import { ComponentType, PropsWithChildren, ReactNode } from 'react';
+import { IParticlesProps, ParticlesPluginRegistrar } from '@tsparticles/react';
+export type { IParticlesProps, ParticlesPluginRegistrar };
+export interface INextParticlesProviderProps extends PropsWithChildren {
+    init: ParticlesPluginRegistrar;
+}
+export declare function NextParticlesProvider({ children, init }: INextParticlesProviderProps): ReactNode;
+export declare const NextParticles: ComponentType<IParticlesProps>;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@tsparticles/nextjs",
+  "version": "4.0.0-beta.12",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "dev": "vite",
+    "build": "prettier --write README.md && pnpm run prettify && tsc && vite build",
+    "build:ci": "prettier --check README.md && pnpm run prettify:ci && tsc && vite build",
+    "lint": "eslint . --max-warnings 0",
+    "preview": "vite preview",
+    "prettify": "prettier --write \"src/**/*.{ts,tsx}\" && prettier --write \"lib/**/*.{ts,tsx}\"",
+    "prettify:ci": "prettier --check \"src/**/*.{ts,tsx}\" && prettier --check \"lib/**/*.{ts,tsx}\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@tsparticles/react": ">=3.0.0",
+    "next": ">=13.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@tsparticles/react": "^4.0.0-beta.12",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.58.2",
+    "@typescript-eslint/parser": "^8.58.2",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^10.2.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "glob": "^13.0.6",
+    "next": "^16.2.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "bdbc95716ce44665fbecfaca8757445e248b562d"
+}