@neo-ui-kit/react 1.0.1 → 1.0.2

package/README.md

@@ -25,7 +25,7 @@ import "@neo-ui-kit/react/styles.css";
 To test repository changes before publishing, run `npm run package` from the repository root and install the resulting archive in a separate application:
 
 ```bash
-npm install /path/to/adui/release/neo-ui-kit-react-1.0.1.tgz
+npm install /path/to/adui/release/neo-ui-kit-react-1.0.2.tgz
 ```
 
 Maintainers publish new versions from `Pro100Dimka/adui` using the `release.yml` GitHub Actions workflow, a matching `v<version>` tag, and the `npm-publication` environment. npm trusts its OIDC identity; no `NPM_TOKEN` is required. The workflow checks the project and packed consumer before publishing the tested archive. Published `1.0.0` cannot be overwritten: code and README changes in npm require a new package version. See the [repository release instructions](https://github.com/Pro100Dimka/adui#npm-пакет).
@@ -182,6 +182,13 @@ import { ThemeProvider, useMotion } from "@neo-ui-kit/react/core";
 
 Canvas-rendered volume knob. Drag near the edge to rotate, drag from the center to move linearly, click the outer scale to jump. Wheel and arrow keys change the value, Shift gives a fine step, PageUp/PageDown change by 10, Home/End set 0/100, Escape cancels a drag, double-click resets. `onValueChange` fires while adjusting, `onValueCommit` after the gesture. `readOnly` turns it into a gauge.
 
+## 1.0.2 release notes
+
+- Restore the complete visualizer on the original documentation route and name it `QuantumBackground`.
+- Export `QuantumBackground` and `QuantumBackgroundProps`. `QuantumFieldExperience` remains a compatible alias of the same component; existing imports keep working.
+- Preserve the original renderer, particles, post-processing, audio controls and theme integration. The separate lightweight `QuantumField` primitive retains its existing API.
+- Both legacy documentation links, `quantum-field` and `quantum-field-experience`, open the `QuantumBackground` page.
+
 ## 1.0.1 release notes
 
 - Clarifies npm installation and documents GitHub Actions trusted publishing through OIDC.
@@ -209,6 +216,17 @@ Version 1.0.0 is the new NEO UI starting point. Rebuild the local archive after
 
 Repository evidence, browser runners, before/after measurements and coverage limits are recorded in `evidence/`. Unit and renderer checks complement actual browser geometry and interaction checks; they do not certify untested physical devices or browser engines.
 
-## Quantum Field experience
+## QuantumBackground
+
+`QuantumBackground` is the complete Quantum Fields visualizer inside an iframe. A compact, transparent field sits above the kit's `FilePicker`, externally controlled `AudioPlayer`, tooltip-labelled microphone/screenshot/fullscreen actions, field selector, and sensitivity control. The selected song name appears on the file button; playback and seeking use the visualizer's single audio source. Other controls live in a closed-by-default “Тонкая настройка” section below the field. It follows the nearest `ThemeProvider` palette. This experience includes MIT-licensed upstream code and CDN-loaded Three.js modules; the upstream notice is shipped as `UPSTREAM-LICENSE.txt`. It is not mounted in overview-card previews.
+
+```tsx
+import { QuantumBackground, ThemeProvider } from "@neo-ui-kit/react";
+import "@neo-ui-kit/react/styles.css";
+
+<ThemeProvider theme="violet">
+  <QuantumBackground />
+</ThemeProvider>
+```
 
-`QuantumFieldExperience` restores the full Quantum Fields visualizer inside an iframe. A compact, transparent field sits above the kit's `FilePicker`, externally controlled `AudioPlayer`, tooltip-labelled microphone/screenshot/fullscreen actions, field selector, and sensitivity control. The selected song name appears on the file button; playback and seeking use the visualizer's single audio source. Other controls live in a closed-by-default “Тонкая настройка” section below the field. It follows the nearest `ThemeProvider` palette. This experience includes MIT-licensed upstream code and CDN-loaded Three.js modules; the upstream notice is shipped as `UPSTREAM-LICENSE.txt`. It is not mounted in overview-card previews. For a smaller self-authored field without transport controls, use `QuantumField` directly.
+`QuantumBackgroundProps` accepts div attributes and an optional `particleBudget` cap. Leave the cap unset for the original adaptive particle count. `QuantumFieldExperience` and `QuantumFieldExperienceProps` remain compatible aliases. The separate lightweight `QuantumField` primitive documented above keeps its original props and rendering; it is not an alias of the full background.

package/dist/components/artwork/QuantumField/QuantumFieldExperience.d.ts

@@ -13,10 +13,14 @@ export declare const quantumFieldExperienceControls: readonly {
     label: string;
     controls: readonly Control[];
 }[];
-export type QuantumFieldExperienceProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+export type QuantumBackgroundProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
     /** Maximum number of visible particles across both field layers. Adaptive quality may draw fewer. */
     particleBudget?: number;
 };
 /** Full MIT-licensed renderer; the host kit owns the controls and theme. */
-export declare function QuantumFieldExperience({ className, particleBudget, ...props }: QuantumFieldExperienceProps): import("react").JSX.Element;
+export declare function QuantumBackground({ className, particleBudget, ...props }: QuantumBackgroundProps): import("react").JSX.Element;
+/** @deprecated Use QuantumBackground. The original import remains compatible. */
+export declare const QuantumFieldExperience: typeof QuantumBackground;
+/** @deprecated Use QuantumBackgroundProps. */
+export type QuantumFieldExperienceProps = QuantumBackgroundProps;
 export {};

package/dist/index.d.ts

@@ -122,8 +122,8 @@ export { NeonWaves } from "./components/artwork/NeonWaves/NeonWaves";
 export type { NeonWavesProps } from "./components/artwork/NeonWaves/NeonWaves";
 export { QuantumField, quantumFieldModes, quantumFieldResolution, quantumFieldAudio } from "./components/artwork/QuantumField/QuantumField";
 export type { QuantumFieldProps, QuantumFieldMode, QuantumFieldQuality, QuantumAudioFrame } from "./components/artwork/QuantumField/QuantumField";
-export { QuantumFieldExperience } from "./components/artwork/QuantumField/QuantumFieldExperience";
-export type { QuantumFieldExperienceProps } from "./components/artwork/QuantumField/QuantumFieldExperience";
+export { QuantumBackground, QuantumFieldExperience } from "./components/artwork/QuantumField/QuantumFieldExperience";
+export type { QuantumBackgroundProps, QuantumFieldExperienceProps } from "./components/artwork/QuantumField/QuantumFieldExperience";
 export { createQuantumFieldAudio } from "./components/artwork/QuantumField/audio";
 export { Spectrum } from "./components/artwork/Spectrum/Spectrum";
 export type { SpectrumProps } from "./components/artwork/Spectrum/Spectrum";

package/dist/index.js

@@ -8228,7 +8228,7 @@ var TransportControls = /* @__PURE__ */ memo(function TransportControls2({ send,
     ] })
   ] });
 });
-function QuantumFieldExperience({ className = "", particleBudget, ...props }) {
+function QuantumBackground({ className = "", particleBudget, ...props }) {
   const frame = useRef28(null);
   const viewport = useRef28(null);
   const theme = useThemePalette();
@@ -8292,19 +8292,20 @@ function QuantumFieldExperience({ className = "", particleBudget, ...props }) {
     send("palette", [theme.primary, theme.secondary]);
   }, [ready, theme.primary, theme.secondary]);
   return /* @__PURE__ */ jsxs39("div", { "data-ad-component": "QuantumFieldExperience", className: `ad-quantum-field-experience ${className}`.trim(), ...props, children: [
-    /* @__PURE__ */ jsx48("div", { className: "ad-qf-viewport", ref: viewport, children: mounted && /* @__PURE__ */ jsx48("iframe", { ref: frame, title: "Quantum Field visualizer", srcDoc: reference_default, allow: "microphone", "data-particle-budget": normalizedBudget }) }),
+    /* @__PURE__ */ jsx48("div", { className: "ad-qf-viewport", ref: viewport, children: mounted && /* @__PURE__ */ jsx48("iframe", { ref: frame, title: "Quantum Background visualizer", srcDoc: reference_default, allow: "microphone", "data-particle-budget": normalizedBudget }) }),
     /* @__PURE__ */ jsxs39("div", { className: "ad-qf-controls", children: [
       /* @__PURE__ */ jsxs39("div", { className: "ad-qf-toolbar", children: [
         /* @__PURE__ */ jsx48(TransportControls, { send, viewport, receive: transportReceiver }),
         /* @__PURE__ */ jsx48("div", { className: "ad-qf-setting-grid ad-qf-essentials", children: essentialControls.map(renderControl) })
       ] }),
       /* @__PURE__ */ jsxs39(CollapsibleSection, { title: "\u0422\u043E\u043D\u043A\u0430\u044F \u043D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0430", description: "\u0421\u0440\u0435\u0434\u0430, \u043A\u0430\u043C\u0435\u0440\u0430, \u044D\u0444\u0444\u0435\u043A\u0442\u044B \u0438 \u0440\u0435\u0430\u043A\u0446\u0438\u044F \u043D\u0430 \u0437\u0432\u0443\u043A", icon: "settings", defaultOpen: false, children: [
-        /* @__PURE__ */ jsx48(Tabs, { label: "\u0422\u043E\u043D\u043A\u0430\u044F \u043D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0430 Quantum Field", items: detailedGroups.map(({ id, label }) => ({ value: id, label })), value: tab, onValueChange: setTab }),
+        /* @__PURE__ */ jsx48(Tabs, { label: "\u0422\u043E\u043D\u043A\u0430\u044F \u043D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0430 Quantum Background", items: detailedGroups.map(({ id, label }) => ({ value: id, label })), value: tab, onValueChange: setTab }),
         /* @__PURE__ */ jsx48("div", { className: "ad-qf-control-panel", role: "tabpanel", "aria-label": group.label, children: /* @__PURE__ */ jsx48("div", { className: "ad-qf-setting-grid", children: group.controls.filter(({ key }) => !enabledBy[key] || settings[enabledBy[key]] === true).map(renderControl) }) })
       ] })
     ] })
   ] });
 }
+var QuantumFieldExperience = QuantumBackground;
 
 // src/components/artwork/QuantumField/audio.ts
 function createQuantumFieldAudio() {
@@ -9570,6 +9571,7 @@ export {
   Planet,
   Popover,
   ProgressBar,
+  QuantumBackground,
   QuantumField,
   QuantumFieldExperience,
   Reveal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo-ui-kit/react",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "NEO UI — React component library",
   "type": "module",
   "license": "MIT",