@uxpilot/openai-astra-shape-cue 1.0.0

package/LICENSE.md

@@ -0,0 +1,39 @@
+# UX Pilot Creative Use License 1.0
+
+For `@uxpilot/openai-astra-shape-cue`.
+
+Inspired by the particle animation on OpenAI’s Astra page. Adapted and packaged by UX Pilot. This project is not affiliated with or endorsed by OpenAI.
+
+Copyright © 2026 UX Pilot Inc., for its original contributions. We do not claim ownership of OpenAI’s work, the underlying visual idea, or third-party software.
+
+## What you can do
+
+You may use, copy, and modify this package for personal or commercial websites, apps, games, and other finished projects, free of charge. This includes paid client work.
+
+You may host the code, serve it to browsers, and deliver it with a finished project, including that project’s source files. Your clients receive the same permissions and conditions.
+
+Keep this license and the applicable third-party notices with copies of the code. You do not need to display a credit or logo in your interface.
+
+## What needs separate permission
+
+Please get written permission from UX Pilot Inc. before:
+
+- Redistributing or selling the package, or a modified version, as a standalone engine, library, plugin, or reusable resource.
+- Including it in component libraries, UI kits, reusable themes or templates, starter kits, asset packs, or marketplaces.
+- Using it in AI design tools, website or app builders, UI editors, prototyping platforms, or other products that offer similar design functionality to UX Pilot, including offering it as a selectable or exportable effect.
+
+These conditions apply to modified versions too. Delivering a finished, client-specific project is allowed; offering a reusable kit for others to build projects is not.
+
+## Hosting and other people’s work
+
+npm, jsDelivr, UNPKG, and their delivery providers may host, cache, and distribute our official releases as needed to provide their services. Hosting providers may also serve copies for permitted finished projects.
+
+Third-party components keep their own licenses and rights. These conditions do not restrict rights granted by their authors or independently created implementations of similar effects. See THIRD_PARTY_NOTICES.md.
+
+The inspiration credit and package name do not grant rights to OpenAI’s or UX Pilot’s trademarks or imply endorsement.
+
+## A few basics
+
+By using the package, you agree to these conditions. Uses outside them need separate written permission. This is a custom license with use restrictions, not an open-source license.
+
+The package is provided “as is,” without warranties. To the extent permitted by law, UX Pilot Inc. is not liable for damages arising from its use. Mandatory rights under applicable law are unaffected.

package/README.md

@@ -0,0 +1,126 @@
+# @uxpilot/openai-astra-shape-cue
+
+Particle shapes for websites and React apps. Inspired by the particle animation on OpenAI’s Astra page; adapted and packaged by UX Pilot. Not affiliated with or endorsed by OpenAI.
+
+Use the minified browser bundle with one script tag, or install the package in a React project. Three.js and postprocessing are included. No runtime CDN imports or base64 decoder are required inside the engine.
+
+## HTML
+
+```html
+<script defer src="https://cdn.jsdelivr.net/npm/@uxpilot/openai-astra-shape-cue@1.0.0/dist/astra.min.js"></script>
+<astra-shape-cue
+  shape="star"
+  transform="load"
+  interaction="rotate"
+  palette="aurora"
+  colors="#9b87ff,#47e2c2,#ffffff"
+  speed="0.4" bloom="0.5" particle-density="2"
+  style="display:block;width:100%;height:600px"
+></astra-shape-cue>
+```
+
+The script registers `<astra-shape-cue>` automatically. Load it once per page. Give the element an explicit height. Generic shapes are `star`, `heart`, `infinity`, `hexagon`, and a procedural `spiral` field. There are no OpenAI logo, cursor, or branded galaxy templates.
+
+Use `transform="off"` for an already formed shape, `load` for gathering on entry, or `scroll` for gathering as the element enters the viewport. Interaction modes are `rotate`, `depth-lens`, and `none`. Palettes are `astra`, `aurora`, and `ember`. Boolean attributes include `ambient`, `auto-rotate`, `parallax`, and `hold-at-end`; use `="false"` to explicitly disable them.
+
+For self hosting, copy `dist/astra.min.js` and the license notices alongside your finished project. Keep versions pinned when using a CDN.
+
+## JavaScript and custom SVG
+
+```js
+import { createShapeCue, mountControls } from '@uxpilot/openai-astra-shape-cue';
+import '@uxpilot/openai-astra-shape-cue/panel.css';
+
+const cue = createShapeCue(document.querySelector('#effect'), {
+  shape: 'heart',
+  transform: 'load',
+  palette: 'aurora',
+  colors: ['#9b87ff', '#47e2c2', '#ffffff'],
+  particles: { density: 3, size: 1.5 },
+  animation: { speed: 0.4, duration: 3 },
+  bloom: 0.5,
+});
+const removeControls = mountControls(cue, document.querySelector('#controls'));
+
+// Supply SVG markup from a local file picker:
+// await cue.loadSVG(file);
+cue.update({ particles: { intensity: 1.5 } });
+cue.setColors(['#ff8e5e', '#ffcf87']);
+cue.pause();
+cue.play();
+cue.replay();
+
+// When your view is removed:
+// removeControls();
+// cue.dispose();
+```
+
+After loading the HTML script, the same functions are available as `window.UXPShapeCue.createShapeCue()` and `window.UXPShapeCue.mountControls()`. The custom element exposes its instance as `element.cue` after connection. Use a dedicated empty `<div>` for `createShapeCue`; do not also mount it on an automatically initialized custom element.
+
+Controls are optional and include a local SVG picker with a 2 MB limit. The public `setShape()` API accepts SVG markup or a shape definition object; callers using their own picker should enforce appropriate file limits. SVG geometry and ancestor transforms are retained; scripts, links, and event handlers are not imported. Separate geometry elements retain their own particle lanes. Uploading a file does not send it to a server.
+
+Use `await cue.loadSVG(file)` to apply the panel's 2 MB validation automatically. `cue.getOptions()` returns a settings snapshot (including custom shapes), `cue.update(snapshot)` restores it, and `cue.onChange(callback)` subscribes to changes. The optional panel stays synchronized with API updates.
+
+## All panel settings are available
+
+```js
+cue.update({
+  shape: 'heart', // Or pass custom SVG markup / a shape definition
+  transform: 'scroll', holdAtEnd: true, parallax: true,
+  scroll: { gather: [0.1, 0.4], disperse: [0.7, 0.95] },
+  interaction: 'rotate', ambient: true, padding: 0.12,
+  config: {
+    pathShapeAutoRotate: true, pathShapeAutoRotateAmount: 0.3,
+    pathShapeScatter: 0.5, rotationDepth: 0.8, faceForward: true,
+    stars: { density: 2, intensity: 1.2, size: 1.5 },
+    bloomIntensity: 0.4,
+    lensFlare: { enabled: true, intensity: 0.2 },
+    interaction: { particleRepel: true, repelRadius: 200 },
+    dirtyGlass: { enabled: false }, orbitalDust: { enabled: true },
+    showCenterCluster: true,
+  },
+});
+```
+
+Every slider, switch, and selector is mapped in [SETTINGS.md](SETTINGS.md#every-panel-control-and-its-api-equivalent). `getControlDefinitions()` exposes that mapping in code. TypeScript checks `cue.set('lensFlare.intensity', 0.2)` paths and value types. For custom scroll drivers, use `cue.setScrollProgress(0.5)` in scroll mode; pass `null` to resume window-driven progress.
+
+## React
+
+```bash
+npm install @uxpilot/openai-astra-shape-cue
+```
+
+```jsx
+'use client';
+import { useState } from 'react';
+import { ShapeCue } from '@uxpilot/openai-astra-shape-cue/react';
+
+export default function Hero() {
+  const [shape, setShape] = useState('heart');
+  return <>
+    <button onClick={() => setShape('star')}>Star</button>
+    <ShapeCue shape={shape}
+      colors={['#9b87ff', '#47e2c2', '#ffffff']}
+      particles={{ density: 2, size: 1.5 }}
+      animation={{ speed: 0.4, duration: 3 }}
+      bloom={0.5}
+      options={{ transform: 'load', interaction: 'rotate' }}
+      style={{ height: 600 }}
+      onError={error => console.error(error)} />
+  </>;
+}
+```
+
+The wrapper initializes in an effect and disposes the renderer on unmount. Importing the package during server rendering does not create a renderer. Inline options work: updates compare values and keep the existing cue. A forwarded ref exposes `cue`, `update()`, `replay()`, `setShape()`, `pause()`, and `play()`.
+
+See [SETTINGS.md](SETTINGS.md) for every option, accepted ranges, HTML attributes, partial-update rules, custom shapes, and the advanced engine configuration reference. Omitted settings retain their current values; send an explicit value to reset them.
+
+Runnable examples: [HTML with settings panel](examples/index.html), [HTML with colors and motion controls](examples/customize.html), and [React component](examples/ReactHero.jsx). The HTML examples use the adjacent `dist/` files and can be served by any static web server. Copy the React component into an app with React and this package installed.
+
+## Requirements
+
+A modern browser with WebGL2 and hardware acceleration. The engine honors reduced-motion preferences and contains no raster fallback. You can inspect `cue.status` (`ready` or `error`) to show your own message when rendering is unavailable. Controls and examples are intended for a single browser document; manage dimensions and placement in your own layout.
+
+## License
+
+Copyright © 2026 UX Pilot Inc., for its original contributions. Free personal/commercial use and modifications in finished projects, subject to the [UX Pilot Creative Use License](LICENSE.md). Standalone redistribution, reusable libraries/templates, and use in competing design tools require separate written permission. This is not an open-source license. See [third-party notices](THIRD_PARTY_NOTICES.md) for bundled dependencies and inspiration credit.

package/SETTINGS.md

@@ -0,0 +1,260 @@
+# Customizing Shape Cue
+
+Use attributes in HTML, props in React, or `cue.update()` in JavaScript. No editing of the bundled code is required. Dimensions and placement belong to your page's CSS.
+
+## Common options
+
+| JavaScript option / React prop | Default | Accepted values |
+|---|---|---|
+| `shape` | `star` | `star`, `heart`, `infinity`, `hexagon`, `spiral`, SVG markup, or a shape object |
+| `colors` | named palette | Array of 1–8 `#rgb` or `#rrggbb` colors; `null` restores the named palette |
+| `particles.density` | 4 | 0.25–4; lower values use fewer particles |
+| `particles.size` | 2.05 | 0.25–3 |
+| `particles.intensity` | 1.35 | 0.1–3 |
+| `particles.scatter` | 0.4 | 0–0.45 |
+| `particles.twinkle` | 0.62 | 0–2 |
+| `animation.speed` | 0.8 | 0–3; controls travel along contours |
+| `animation.duration` | 5.5 | 1–10 seconds; approximate gather settling time, not a fixed timeline |
+| `animation.playing` | true | Pause/resume particle flow while retaining pointer interaction |
+| `bloom` | 0.7 | 0–2 |
+| `transform` | `load` | `load` (gather on entry), `scroll` (gather with viewport progress), `off` (already formed) |
+| `interaction` | `rotate` | `rotate`, `depth-lens`, `none` |
+| `palette` | `astra` | `astra`, `aurora`, `ember`; explicit `colors` take priority |
+| `background` | `#000` | A CSS color or `transparent` |
+| `padding` | 0.1 | 0–0.45; fraction of the stage kept clear |
+| `autoRotate` | true | Enable the shape's built-in rotation during gathering |
+| `ambient` | false | Background glow and vignette |
+| `holdAtEnd` | false | Retain a shape after it scrolls past |
+| `parallax` | true | Dispersed particle parallax in scroll mode |
+| `tier` | 3 | 1 (lighter), 2 (balanced), 3 (full); 0 disables WebGL and reports an error |
+| `interactionLabel` | generated | Accessible label for pointer/keyboard rotation |
+
+The renderer may rebuild its GPU resources for changes to palette, density, size, scatter, depth, or quality. Changes are batched; the cue instance and its canvas remain mounted. Cheap settings such as speed and bloom update without rebuilding the field.
+
+## HTML attributes
+
+```html
+<astra-shape-cue shape="heart"
+  colors="#9b87ff,#47e2c2,#ffffff"
+  particle-density="2" particle-size="1.5"
+  speed="0.4" gather-duration="3" bloom="0.5"
+  transform="load" interaction="rotate"
+  style="display:block;height:500px"
+></astra-shape-cue>
+```
+
+Load `dist/astra.min.js` first, or use `defer` and place the element in the HTML. The additional attributes are `colors`, `particle-density`, `particle-size`, `speed`, `gather-duration`, `bloom`, and `paused`. `paused` pauses particle flow; removing it or setting it to `false` resumes. Removing another shortcut attribute restores its documented default. Set boolean attributes such as `ambient` and `auto-rotate` to `false` to explicitly disable them. Removing a `colors` attribute restores the default Astra palette.
+
+## Update, pause, and resume
+
+```js
+cue.update({
+  colors: ['#ff8e5e', '#ffcf87'],
+  particles: { density: 2, size: 1.2 },
+  animation: { speed: 0.35, duration: 3 },
+  bloom: 0.4,
+});
+cue.pause();
+cue.play();
+cue.setColors(['#9b87ff', '#ffffff']);
+cue.update({ palette: 'aurora', colors: null });
+cue.replay();
+```
+
+Updates are patches: omitted values remain as they are. Explicitly send the desired default to reset a setting. This also applies when React props/options change; removing a prop is not a reset. React's direct `colors`, `particles`, `animation`, and `bloom` props override the same fields in `options`. Shortcuts override matching advanced `config` fields in the same update. `cue.update()` validates supported options before applying them and reports invalid values instead of silently ignoring them.
+
+## Custom shapes
+
+```js
+cue.setShape('<svg viewBox="0 0 200 100"><circle cx="50" cy="50" r="35"/><circle cx="150" cy="50" r="25"/></svg>');
+// Or supply path geometry directly:
+cue.setShape({ width:100, height:100, paths:['M10 10 L90 10 L50 90 Z'] });
+```
+
+Use separate SVG geometry elements for disconnected contours. SVG markup is treated as geometry only; scripts, links, and event handlers are excluded. Files selected with the optional control panel stay local and are limited to 2 MB. Your own file picker can pass `await file.text()` to `setShape()`.
+
+The `spiral` preset is a procedural five-arm field, with no imported OpenAI SVG artwork. Center cluster and orbital dust are most visible in that native field. The center cluster is intentionally suppressed on formed SVG shapes to avoid a duplicate contour. Shape-scatter, shape-depth, and SVG gathering controls apply to the outline presets and custom SVGs; native `spiral` stays in its field mode.
+
+```js
+// Direct file upload, with the same validation as the panel:
+await cue.loadSVG(fileInput.files[0]);
+// Also accepts a Blob or markup; it does not fetch URLs.
+await cue.loadSVG('<svg viewBox="0 0 100 100"><circle cx="50" cy="50" r="35"/></svg>');
+```
+
+`loadSVG()` enforces 2 MB, leaves the previous shape in place on validation failure, and prevents a slower earlier upload from overwriting a newer shape choice.
+
+## Scroll behavior
+
+```js
+cue.update({
+  transform: 'scroll',
+  holdAtEnd: true,
+  parallax: true,
+  scroll: { gather: [0.1, 0.4], disperse: [0.7, 0.95] },
+});
+```
+
+Progress runs from 0 when the stage enters the bottom of the window to 1 when it leaves the top. `gather` sets the formation interval; `disperse` sets the exit interval. Both ranges must increase within 0–1. Defaults are `[0, 0.36]` and `[0.5, 0.86]`. `holdAtEnd: true` skips exit dispersion. `transform: 'load'` gathers once on visibility; `transform: 'off'` keeps the SVG formed. Reduced-motion users see the formed SVG immediately.
+
+For your own scroll container, timeline, or scroll library, call `cue.setScrollProgress(progress)` with a normalized value. This drives the same gathering intervals in `transform: 'scroll'` mode. `cue.setScrollProgress(null)` returns to window-driven behavior. Native dispersed parallax still follows window scrolling. React accepts `scroll` as a direct prop; set `transform`, `holdAtEnd`, and `parallax` through `options`, and use the ref for manual progress.
+
+## Read, save, restore, and observe settings
+
+```js
+const saved = cue.getOptions(); // Detached, JSON-serializable snapshot
+const unsubscribe = cue.onChange(settings => console.log(settings));
+cue.update({config:{lensFlare:{enabled:false},interaction:{repelRadius:220}}});
+cue.update(saved); // Restore the snapshot
+unsubscribe();
+```
+
+Snapshots include the custom SVG/shape and all effective engine settings. Treat uploaded artwork in saved settings as user data. Change notifications are batched once per microtask and omitted when values have not changed. They cover both API calls and stock-panel edits; they do not fire for animation frames. React exposes `onSettingsChange` and ref methods `getOptions()`, `loadSVG()`, and `setScrollProgress()`.
+
+## React
+
+```jsx
+<ShapeCue shape="heart"
+  colors={['#9b87ff', '#47e2c2', '#ffffff']}
+  particles={{ density:2, size:1.5 }}
+  animation={{ speed:0.4, duration:3, playing:true }}
+  bloom={0.5}
+  options={{ interaction:'rotate', background:'transparent' }}
+  style={{ height:500 }}
+/>
+```
+
+You can use inline option objects. The wrapper compares setting values and updates the same cue; ordinary parent renders do not dispose and recreate it. `onReady` fires after creation, and `onError` receives initialization or update errors. Importing during server rendering is safe; renderer creation waits until client mount. React Strict Mode intentionally exercises mounting twice in development.
+
+## Optional settings panel
+
+Import `@uxpilot/openai-astra-shape-cue/panel.css` and call `mountControls(cue, container)`. It returns a cleanup function. The panel and API stay synchronized: programmatic updates refresh control values, and panel edits emit `onChange`. Custom colors/backgrounds appear as custom selections. Use `getControlDefinitions()` to create your own UI with the same control mapping and limits. The panel is optional and contains no page-level layout styles.
+
+
+## Every panel control and its API equivalent
+
+Generated from the actual control panel. Use the option path with `cue.update()`; paths beginning with `config.` also support `cue.set()` with that prefix removed. `getControlDefinitions()` returns this mapping, defaults, ranges, and choices for building your own UI.
+
+| Panel control | Option path | Range / choices | Default |
+|---|---|---|---|
+| Shape | `shape` | star, heart, infinity, hexagon, spiral, custom | `"star"` |
+| Transform on scroll | `transform` | scroll, load, off | `"load"` |
+| Interaction | `interaction` | rotate, depth-lens, none | `"rotate"` |
+| Palette | `palette` | astra, aurora, ember | `"astra"` |
+| Background | `background` | #000, #0b0f1a, transparent | `"#000"` |
+| Hold shape after scrolling past | `holdAtEnd` | true / false | `false` |
+| Scroll parallax while dispersed | `parallax` | true / false | `true` |
+| Ambient glow + vignette | `ambient` | true / false | `false` |
+| Padding | `padding` | 0–0.4 (step 0.01) | `0.1` |
+| Auto-rotate amount | `config.pathShapeAutoRotateAmount` | 0–1.2 (step 0.01) | `0.42` |
+| Shape scatter | `config.pathShapeScatter` | 0–3 (step 0.01) | `1` |
+| Shape depth | `config.rotationDepth` | 0–2 (step 0.01) | `1.4` |
+| Star density | `config.stars.density` | 0.25–4 (step 0.05) | `4` |
+| Star intensity | `config.stars.intensity` | 0.1–3 (step 0.01) | `1.35` |
+| Star size | `config.stars.size` | 0.25–3 (step 0.01) | `2.05` |
+| Bloom | `config.bloomIntensity` | 0–2 (step 0.01) | `0.7` |
+| Lens flare | `config.lensFlare.intensity` | 0–1.5 (step 0.01) | `0.28` |
+| Pointer repel radius | `config.interaction.repelRadius` | 16–360 (step 1) | `176` |
+| Auto-rotate shape | `config.pathShapeAutoRotate` | true / false | `true` |
+| Return to front on release | `config.faceForward` | true / false | `true` |
+| Pointer repels particles | `config.interaction.particleRepel` | true / false | `true` |
+| Lens flare | `config.lensFlare.enabled` | true / false | `true` |
+| Dirty glass + grain | `config.dirtyGlass.enabled` | true / false | `true` |
+| Orbital dust | `config.orbitalDust.enabled` | true / false | `false` |
+| Center cluster | `config.showCenterCluster` | true / false | `true` |
+| Upload SVG | `await cue.loadSVG(file)` | SVG File, Blob, or markup, max 2 MB | — |
+| Replay gather | `cue.replay()` | Action | — |
+| Collapse panel | Panel display only | No engine setting | Expanded |
+
+
+## Advanced engine configuration
+
+All fields are optional and support nested partial updates through `config`. The values below are the engine defaults. Animation preset choices are `converge-tilt`, `legacy-zoom`, `grow`, `accretion-exhale`, and `none`; their intro behavior depends on transform mode. `animation.duration` controls SVG gathering independently of those intro presets.
+
+| Setting | Default |
+|---|---|
+| `animationPlaying` | `true` |
+| `animationRestartKey` | `0` |
+| `bloomIntensity` | `0.7` |
+| `bloomThreshold` | `0.08` |
+| `colorMode` | `true` |
+| `convergeDuration` | `5.5` |
+| `faceForward` | `true` |
+| `pathShapeAutoRotate` | `true` |
+| `pathShapeAutoRotateAmount` | `0.42` |
+| `pathShapeAutoRotateSpeed` | `0.22` |
+| `pathShapeScatter` | `1` |
+| `rotationDepth` | `1.4` |
+| `scrollDisperseDistance` | `800` |
+| `scrollEffects` | `true` |
+| `scrollStarDriftSpeed` | `3` |
+| `scrollStartOffset` | `0` |
+| `scrollTextFadeDistance` | `200` |
+| `showCenterCluster` | `true` |
+| `accretionExhale.accretionRatio` | `0.42` |
+| `accretionExhale.ambientAmount` | `0.04` |
+| `accretionExhale.ambientSpeed` | `0.55` |
+| `accretionExhale.coreIntensity` | `1.45` |
+| `accretionExhale.duration` | `8` |
+| `accretionExhale.exhaleStrength` | `0.42` |
+| `accretionExhale.inwardStrength` | `1.2` |
+| `accretionExhale.propagationSoftness` | `0.16` |
+| `accretionExhale.settleDuration` | `1.2` |
+| `accretionExhale.startScale` | `0.58` |
+| `animationPreset` | `"converge-tilt"` |
+| `colorPalette` | `"astra"` |
+| `colorPaletteColors` | `["#6DCBF4","#7AB1FE","#F87915","#FA994C","#F5F6FB"]` |
+| `dirtyGlass.distortion` | `0.68` |
+| `dirtyGlass.drift` | `true` |
+| `dirtyGlass.driftStrength` | `0.28` |
+| `dirtyGlass.enabled` | `true` |
+| `dirtyGlass.grain` | `0.031` |
+| `dirtyGlass.procedural` | `0` |
+| `dirtyGlass.texture` | `0` |
+| `grow.duration` | `8` |
+| `grow.growthSpeed` | `0.55` |
+| `grow.softness` | `0.075` |
+| `grow.startZoom` | `4` |
+| `interaction.depthDisplacement` | `0.5` |
+| `interaction.followDamping` | `6` |
+| `interaction.illumination` | `0.55` |
+| `interaction.magnification` | `0.18` |
+| `interaction.particleRepel` | `true` |
+| `interaction.repelDistance` | `52` |
+| `interaction.repelFalloff` | `2` |
+| `interaction.repelHighlight` | `0.16` |
+| `interaction.repelHighlightRadius` | `196` |
+| `interaction.repelPressMultiplier` | `2.2` |
+| `interaction.repelRadius` | `176` |
+| `interaction.repelReturnSpring` | `2.8` |
+| `interaction.repelSpring` | `7` |
+| `interaction.rotationLag` | `0.68` |
+| `interaction.radius` | `156` |
+| `interaction.smearCurl` | `0.24` |
+| `interaction.smearTrailLength` | `2.25` |
+| `interactionMode` | `"rotate"` |
+| `lensFlare.animated` | `true` |
+| `lensFlare.enabled` | `true` |
+| `lensFlare.ghosts` | `0.1` |
+| `lensFlare.halo` | `0.12` |
+| `lensFlare.intensity` | `0.28` |
+| `lensFlare.secondary` | `0.55` |
+| `lensFlare.streakLength` | `0.03485` |
+| `lensFlare.streaks` | `0.18` |
+| `lensFlare.verticalStreaks` | `1` |
+| `orbitalDust.density` | `0.55` |
+| `orbitalDust.driftSpeed` | `0.2` |
+| `orbitalDust.enabled` | `false` |
+| `orbitalDust.intensity` | `2` |
+| `orbitalDust.reach` | `0.17` |
+| `orbitalDust.spread` | `0.4` |
+| `orbitalDust.tightSpread` | `0.03` |
+| `stars.density` | `4` |
+| `stars.densityFalloff` | `0.22` |
+| `stars.flowInward` | `true` |
+| `stars.flowSpeed` | `0.8` |
+| `stars.intensity` | `1.35` |
+| `stars.scatter` | `0.4` |
+| `stars.size` | `2.05` |
+| `stars.sizeFalloff` | `0.45` |
+| `stars.twinkleSpeed` | `0.62` |

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,53 @@
+# Third-party notices
+
+Inspired by the particle animation on OpenAI’s Astra page. Adapted and packaged by UX Pilot. Not affiliated with or endorsed by OpenAI. OpenAI-specific logos and authored SVG artwork are not included.
+
+The following components are bundled with the engine. Their licenses apply independently of the UX Pilot license.
+
+## three 0.180.0
+
+The MIT License
+
+Copyright © 2010-2025 three.js authors
+
+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.
+
+
+## postprocessing 6.37.8
+
+Copyright © 2015 Raoul van Rüschen
+
+This software is provided 'as-is', without any express or implied warranty. In
+no event will the authors be held liable for any damages arising from the use of
+this software.
+
+Permission is granted to anyone to use this software for any purpose, including
+commercial applications, and to alter it and redistribute it freely, subject to
+the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not claim
+   that you wrote the original software. If you use this software in a product,
+   an acknowledgment in the product documentation would be appreciated but is
+   not required.
+
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+
+3. This notice may not be removed or altered from any source distribution.
+