@northstar-js/react 0.1.0 → 0.2.0

package/dist/actions.d.ts

@@ -1,21 +1,88 @@
+import { type ButtonFinish, type Material } from './provider.js';
 import { type Size, type Tone } from './internal/util.js';
+import { type Expand } from './internal/expand.js';
 export type ButtonVariant = 'primary' | 'secondary' | 'ghost';
+/**
+ * `silver` is an alias for the machined spin finish (`finish="spin"`), kept
+ * for the brushed-silver API it replaced. Spin is the default everywhere now.
+ */
+export type ButtonTone = Tone | 'silver';
+/**
+ * `pill` (default): a capsule (`radius.control.pill`), and a perfect circle
+ * when the button is square (icon-only). `rounded` opts out to tight corners
+ * (`radius.control.rounded`, or `radius.glass.control` on glass).
+ */
+export type ButtonShape = 'pill' | 'rounded';
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: ButtonVariant;
     size?: Size;
-    tone?: Tone;
+    tone?: ButtonTone;
+    /** Default `pill`; `rounded` opts out of the pill shape. */
+    shape?: ButtonShape;
+    /**
+     * `spin`: machined metal, a conic sweep under a fine concentric grain that
+     * turns with the pointer, Glacier-anodized on primary; ghost takes a faint
+     * wash of it on hover and focus; icon-only circles are turned knobs.
+     * `soft`: the tonal fill with the tactile texture. Default: the provider's
+     * `buttonFinish` (`spin`). Glass buttons (`material="glass"`) keep glass.
+     */
+    finish?: ButtonFinish;
+    /** Leading icon (decorative; the label names the button). */
+    icon?: React.ReactNode;
+    /**
+     * Icon-first: with `icon`, `true` shows only the icon and eases the full
+     * label open on hover and keyboard focus (never truncated; always open on
+     * touch). `always` keeps it open. Default false.
+     */
+    expand?: Expand;
     loading?: boolean;
     /** Accessible text announced while loading. */
     loadingLabel?: string;
+    /** Shows the success check (it draws in, then rests). Purely presentational; announce the outcome elsewhere too. */
+    success?: boolean;
+    /** Accessible text added while `success` is set. Default "Done". */
+    successLabel?: string;
+    /** `glass` gives secondary and ghost buttons the liquid-glass material. Default `solid`. */
+    material?: Material;
+    /** Leans toward the pointer by a few pixels and springs back. Pointer only; off under reduced motion. */
+    magnetic?: boolean;
     ref?: React.Ref<HTMLButtonElement>;
 }
-export declare function Button({ variant, size, tone, loading, loadingLabel, disabled, className, children, type, ...rest }: ButtonProps): import("react/jsx-runtime").JSX.Element;
-export interface IconButtonProps extends Omit<ButtonProps, 'children'> {
+export declare function Button({ variant, size, tone, shape, finish: finishProp, icon, expand, loading, loadingLabel, success, successLabel, material, magnetic, disabled, className, children, type, ref, ...rest }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export interface IconButtonProps extends Omit<ButtonProps, 'children' | 'icon'> {
     /** Required accessible name. */
     label: string;
     icon: React.ReactNode;
+    /**
+     * Icon-led: `true` shows the icon and, on hover and keyboard focus, eases
+     * open to reveal the full label (never truncated). `always` keeps the label
+     * shown. Default false: icon only, with the label as a native tooltip.
+     */
+    expand?: Expand;
+}
+export declare function IconButton({ label, icon, expand, className, title, ...rest }: IconButtonProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * A label that is collapsed to zero width and eases open (grid 0fr → 1fr) when
+ * an ancestor control is hovered or focused, so the whole text shows and
+ * nothing is cut with an ellipsis. It stays in the accessibility tree. The
+ * public face of the shared ExpandLabel primitive; give the control the
+ * `ns-expand-host` class (or use a component's `expand` prop).
+ */
+export declare function RevealLabel({ className, children, ...rest }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
+export interface ToolbarProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Required accessible name. */
+    label: string;
+    orientation?: 'horizontal' | 'vertical';
+    /** Sits on liquid glass, floating. Default false. */
+    glass?: boolean;
+}
+/** A toolbar of icon-led items: arrow keys move between them, Home and End jump. */
+export declare function Toolbar({ label, orientation, glass, className, onKeyDown, ...rest }: ToolbarProps): import("react/jsx-runtime").JSX.Element;
+export interface ToolbarItemProps extends Omit<IconButtonProps, 'expand'> {
+    /** Default true: the label reveals on hover and focus. */
+    expand?: Expand;
 }
-export declare function IconButton({ label, icon, className, title, ...rest }: IconButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ToolbarItem({ expand, variant, className, ...rest }: ToolbarItemProps): import("react/jsx-runtime").JSX.Element;
 export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
     tone?: Tone;
     /** Adds rel="noreferrer" and target="_blank". */

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAChF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAqB,EACrB,IAAW,EACX,IAAgB,EAChB,OAAe,EACf,YAAwB,EACxB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,IAAe,EACf,GAAG,IAAI,EACR,EAAE,WAAW,2CAeb;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IACpE,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,eAAe,2CAMrF;AAED,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAC9E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAED,wBAAgB,IAAI,CAAC,EAAE,IAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,2CAQhF;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAS5F"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":"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"}

package/dist/actions.js

@@ -1,12 +1,58 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cx } from './internal/util.js';
-export function Button({ variant = 'secondary', size = 'md', tone = 'neutral', loading = false, loadingLabel = 'Loading', disabled, className, children, type = 'button', ...rest }) {
-    return (_jsxs("button", { ...rest, type: type, className: cx('ns-button', `ns-button--${variant}`, `ns-size-${size}`, tone === 'signal' && 'ns-tone-signal', className), disabled: disabled || loading, "aria-busy": loading || undefined, "data-loading": loading || undefined, children: [loading && _jsx("span", { className: "ns-spinner", "aria-hidden": "true" }), _jsx("span", { className: "ns-button__label", children: children }), loading && _jsx("span", { className: "ns-visually-hidden", children: loadingLabel })] }));
+import { useNorthstar } from './provider.js';
+import { usePointerTracking } from './internal/interaction.js';
+import { cx, mergeRefs } from './internal/util.js';
+import { rovingKeyDown } from './internal/layers.js';
+import { ExpandIcon, ExpandLabel, expandHost } from './internal/expand.js';
+/** The north star: a fixed four-point mark with an orbit turning round it while work runs. */
+function NorthStarSpinner() {
+    return (_jsxs("svg", { className: "ns-spinner ns-spinner--star", viewBox: "0 0 16 16", width: "14", height: "14", "aria-hidden": "true", focusable: "false", children: [_jsx("path", { className: "ns-spinner__star", d: "M8 3 8.8 7.2 13 8 8.8 8.8 8 13 7.2 8.8 3 8 7.2 7.2Z", fill: "currentColor" }), _jsx("circle", { className: "ns-spinner__orbit", cx: "8", cy: "8", r: "6.5", fill: "none", stroke: "currentColor", strokeWidth: "1" })] }));
 }
-export function IconButton({ label, icon, className, title, ...rest }) {
+function SuccessCheck() {
+    return (_jsx("svg", { className: "ns-button__check", viewBox: "0 0 16 16", width: "14", height: "14", "aria-hidden": "true", focusable: "false", children: _jsx("path", { d: "M3.5 8.5 6.5 11.5 12.5 4.5", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round", pathLength: 1 }) }));
+}
+export function Button({ variant = 'secondary', size = 'md', tone = 'neutral', shape = 'pill', finish: finishProp, icon, expand = false, loading = false, loadingLabel = 'Loading', success = false, successLabel = 'Done', material, magnetic = false, disabled, className, children, type = 'button', ref, ...rest }) {
+    const ns = useNorthstar();
+    const glass = material === 'glass';
+    const silver = tone === 'silver';
+    const finish = finishProp ?? (silver ? 'spin' : ns.buttonFinish);
+    const spin = finish === 'spin' && !glass;
+    // The spin sweep turns with the pointer and glass's spotlight follows it, so both track it.
+    const track = usePointerTracking(magnetic || glass || spin, { magnetic: magnetic ? 4 : 0 });
+    const done = success && !loading;
+    const host = icon !== undefined && icon !== null && icon !== false ? expandHost(expand) : {};
+    const expanding = !!host.className;
+    return (_jsxs("button", { ...rest, ref: mergeRefs(ref, track), type: type, className: cx('ns-button', `ns-button--${variant}`, `ns-size-${size}`, tone === 'signal' && 'ns-tone-signal', silver && 'ns-button--silver', shape === 'rounded' && 'ns-button--rounded', glass && 'ns-button--glass', expanding && 'ns-button--expand', host.className, className), "data-expand": host['data-expand'], "data-shape": shape, "data-finish": finish, "data-material": material, disabled: disabled || loading, "aria-busy": loading || undefined, "data-loading": loading || undefined, "data-success": done || undefined, "data-magnetic": magnetic || undefined, children: [loading && _jsx(NorthStarSpinner, {}), done && _jsx(SuccessCheck, {}), icon !== undefined && icon !== null && icon !== false && !loading && !done && _jsx(ExpandIcon, { className: "ns-button__icon", children: icon }), expanding ? (_jsx(ExpandLabel, { className: "ns-button__label", children: children })) : (_jsx("span", { className: "ns-button__label", children: children })), loading && _jsx("span", { className: "ns-visually-hidden", children: loadingLabel === 'Loading' ? ns.messages.loading : loadingLabel }), done && _jsx("span", { className: "ns-visually-hidden", children: successLabel })] }));
+}
+export function IconButton({ label, icon, expand = false, className, title, ...rest }) {
+    if (expand) {
+        return (_jsx(Button, { ...rest, title: title, icon: icon, expand: expand, className: cx('ns-icon-button', 'ns-icon-button--expand', expand === 'always' && 'ns-icon-button--open', className), children: label }));
+    }
     return (_jsx(Button, { ...rest, "aria-label": label, title: title ?? label, className: cx('ns-icon-button', className), children: icon }));
 }
+/**
+ * A label that is collapsed to zero width and eases open (grid 0fr → 1fr) when
+ * an ancestor control is hovered or focused, so the whole text shows and
+ * nothing is cut with an ellipsis. It stays in the accessibility tree. The
+ * public face of the shared ExpandLabel primitive; give the control the
+ * `ns-expand-host` class (or use a component's `expand` prop).
+ */
+export function RevealLabel({ className, children, ...rest }) {
+    return (_jsx(ExpandLabel, { ...rest, className: className, children: children }));
+}
+/** A toolbar of icon-led items: arrow keys move between them, Home and End jump. */
+export function Toolbar({ label, orientation = 'horizontal', glass = false, className, onKeyDown, ...rest }) {
+    return (_jsx("div", { role: "toolbar", "aria-label": label, "aria-orientation": orientation, ...rest, className: cx('ns-toolbar', `ns-toolbar--${orientation}`, glass && 'ns-liquid ns-liquid--sm ns-liquid--floating ns-liquid--tint-subtle', className), onKeyDown: (e) => {
+            onKeyDown?.(e);
+            rovingKeyDown(e, '.ns-toolbar__item', orientation);
+        } }));
+}
+export function ToolbarItem({ expand = true, variant = 'ghost', className, ...rest }) {
+    return _jsx(IconButton, { ...rest, expand: expand, variant: variant, className: cx('ns-toolbar__item', className) });
+}
 export function Link({ tone = 'signal', external, className, ...rest }) {
+    // The underline draws in from the left on hover and keyboard focus (CSS).
     return (_jsx("a", { ...(external ? { target: '_blank', rel: 'noreferrer' } : {}), ...rest, className: cx('ns-link', tone === 'neutral' && 'ns-link--neutral', className) }));
 }
 export function ButtonGroup({ attached = false, label, className, ...rest }) {

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAwB,MAAM,oBAAoB,CAAC;AAc9D,MAAM,UAAU,MAAM,CAAC,EACrB,OAAO,GAAG,WAAW,EACrB,IAAI,GAAG,IAAI,EACX,IAAI,GAAG,SAAS,EAChB,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,SAAS,EACxB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,QAAQ,EACf,GAAG,IAAI,EACK;IACZ,OAAO,CACL,qBACM,IAAI,EACR,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,EAAE,CAAC,WAAW,EAAE,cAAc,OAAO,EAAE,EAAE,WAAW,IAAI,EAAE,EAAE,IAAI,KAAK,QAAQ,IAAI,gBAAgB,EAAE,SAAS,CAAC,EACxH,QAAQ,EAAE,QAAQ,IAAI,OAAO,eAClB,OAAO,IAAI,SAAS,kBACjB,OAAO,IAAI,SAAS,aAEjC,OAAO,IAAI,eAAM,SAAS,EAAC,YAAY,iBAAa,MAAM,GAAG,EAC9D,eAAM,SAAS,EAAC,kBAAkB,YAAE,QAAQ,GAAQ,EACnD,OAAO,IAAI,eAAM,SAAS,EAAC,oBAAoB,YAAE,YAAY,GAAQ,IAC/D,CACV,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAmB;IACpF,OAAO,CACL,KAAC,MAAM,OAAK,IAAI,gBAAc,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAC,YACnG,IAAI,GACE,CACV,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAa;IAC/E,OAAO,CACL,eACM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACzD,IAAI,EACR,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,IAAI,KAAK,SAAS,IAAI,kBAAkB,EAAE,SAAS,CAAC,GAC7E,CACH,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,EAAoB;IAC3F,OAAO,CACL,cACE,IAAI,EAAC,OAAO,gBACA,KAAK,KACb,IAAI,EACR,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,QAAQ,IAAI,2BAA2B,EAAE,SAAS,CAAC,GACpF,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":"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"}

package/dist/backdrops/StarBackdrop.d.ts

@@ -0,0 +1,31 @@
+import { type BackdropDensity } from './math.js';
+import { type BackdropVariant } from './scenes.js';
+export interface StarBackdropProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Which backdrop. Every variant takes the same props, so they swap freely. Default `constellation-atlas`. */
+    variant?: BackdropVariant;
+    /** Force Night or Day colours for this backdrop; by default it follows the surrounding theme. */
+    theme?: 'night' | 'day';
+    /**
+     * How many stars: `high` is the approved design, `medium` about 65 % of it
+     * and `low` about 35 %, capped at 480 and 240 marks. The signal stars always
+     * stay. Default `medium`.
+     */
+    density?: BackdropDensity;
+    /** Animation speed multiplier (2 is twice as fast). 0 holds still. Default 1. */
+    speed?: number;
+    /** Holds every animation where it is. Backdrops also pause by themselves offscreen and while the page is hidden. */
+    paused?: boolean;
+    /** Paint the backdrop ground (`--ns-backdrop-ground`). `false` draws the stars only, over whatever is behind. Default true. */
+    ground?: boolean;
+    ref?: React.Ref<HTMLDivElement>;
+}
+/**
+ * An animated star field that fills its container: absolutely positioned,
+ * `aria-hidden`, never takes the pointer, and covers any aspect ratio (the
+ * 720 × 450 design frame is sliced to fit). Geometry is seeded and memoised,
+ * so the server and the client draw the same stars. Animations are CSS only;
+ * they pause offscreen and while the document is hidden, and under reduced
+ * motion the backdrop is a still frame. Load `@northstar-js/react/backdrops.css`.
+ */
+export declare function StarBackdrop({ variant, theme, density, speed, paused, ground, className, style, ref, ...rest }: StarBackdropProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=StarBackdrop.d.ts.map

package/dist/backdrops/StarBackdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StarBackdrop.d.ts","sourceRoot":"","sources":["../../src/backdrops/StarBackdrop.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC/F,8GAA8G;IAC9G,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,iGAAiG;IACjG,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oHAAoH;IACpH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+HAA+H;IAC/H,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC;AAiBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAA+B,EAC/B,KAAK,EACL,OAAkB,EAClB,KAAS,EACT,MAAc,EACd,MAAa,EACb,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,IAAI,EACR,EAAE,iBAAiB,2CAmEnB"}

package/dist/backdrops/StarBackdrop.js

@@ -0,0 +1,84 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useId, useMemo, useRef, useState } from 'react';
+import { DENSITY, FRAME } from './math.js';
+import { SCENES, sceneData } from './scenes.js';
+const QUERY = '(prefers-reduced-motion: reduce)';
+function useReducedMotion() {
+    const [reduced, setReduced] = useState(false);
+    useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return;
+        const mq = window.matchMedia(QUERY);
+        setReduced(mq.matches);
+        const on = () => setReduced(mq.matches);
+        mq.addEventListener?.('change', on);
+        return () => mq.removeEventListener?.('change', on);
+    }, []);
+    return reduced;
+}
+/**
+ * An animated star field that fills its container: absolutely positioned,
+ * `aria-hidden`, never takes the pointer, and covers any aspect ratio (the
+ * 720 × 450 design frame is sliced to fit). Geometry is seeded and memoised,
+ * so the server and the client draw the same stars. Animations are CSS only;
+ * they pause offscreen and while the document is hidden, and under reduced
+ * motion the backdrop is a still frame. Load `@northstar-js/react/backdrops.css`.
+ */
+export function StarBackdrop({ variant = 'constellation-atlas', theme, density = 'medium', speed = 1, paused = false, ground = true, className, style, ref, ...rest }) {
+    const scene = SCENES[variant] ?? SCENES['constellation-atlas'];
+    const id = `ns-bd-${useId().replace(/[^a-zA-Z0-9_-]/g, '')}`;
+    const level = density in DENSITY ? density : 'medium';
+    const key = scene === SCENES[variant] ? variant : 'constellation-atlas';
+    const content = useMemo(() => scene.render(sceneData(key, level), id), [scene, key, level, id]);
+    const reduced = useReducedMotion();
+    const node = useRef(null);
+    const still = !(speed > 0);
+    // Pause offscreen and while the page is hidden: written straight to the
+    // element, so it never re-renders the scene. 3D scenes are scaled to cover.
+    const kind = scene.kind;
+    useEffect(() => {
+        const el = node.current;
+        if (!el || typeof window === 'undefined')
+            return;
+        let offscreen = false;
+        const sync = () => {
+            const idle = offscreen || (typeof document !== 'undefined' && document.visibilityState === 'hidden');
+            if (idle)
+                el.setAttribute('data-idle', '');
+            else
+                el.removeAttribute('data-idle');
+        };
+        const io = typeof IntersectionObserver === 'function'
+            ? new IntersectionObserver((entries) => {
+                for (const e of entries)
+                    offscreen = !e.isIntersecting;
+                sync();
+            })
+            : null;
+        io?.observe(el);
+        const ro = kind === '3d' && typeof ResizeObserver === 'function'
+            ? new ResizeObserver(() => {
+                const k = Math.max(el.clientWidth / FRAME.w, el.clientHeight / FRAME.h);
+                if (k > 0)
+                    el.style.setProperty('--ns-bd-k', k.toFixed(4));
+            })
+            : null;
+        ro?.observe(el);
+        document.addEventListener('visibilitychange', sync);
+        sync();
+        return () => {
+            io?.disconnect();
+            ro?.disconnect();
+            document.removeEventListener('visibilitychange', sync);
+        };
+    }, [kind]);
+    return (_jsx("div", { ...rest, ref: (el) => {
+            node.current = el;
+            if (typeof ref === 'function')
+                ref(el);
+            else if (ref)
+                ref.current = el;
+        }, "aria-hidden": "true", "data-variant": variant, "data-density": density, "data-theme": theme, "data-paused": paused || still || undefined, "data-motion": reduced ? 'reduced' : undefined, className: ['ns-backdrop', `ns-backdrop--${variant}`, `ns-backdrop--${kind}`, ground ? '' : 'ns-backdrop--bare', className ?? ''].filter(Boolean).join(' '), style: { '--ns-bd-speed': still ? 1 : Math.min(20, Math.max(0.05, speed)), ...style }, children: content }));
+}
+//# sourceMappingURL=StarBackdrop.js.map

package/dist/backdrops/StarBackdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StarBackdrop.js","sourceRoot":"","sources":["../../src/backdrops/StarBackdrop.tsx"],"names":[],"mappings":"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"}

package/dist/backdrops/index.d.ts

@@ -0,0 +1,7 @@
+export { StarBackdrop } from './StarBackdrop.js';
+export type { StarBackdropProps } from './StarBackdrop.js';
+export { BACKDROP_VARIANTS, countMarks, sceneData } from './scenes.js';
+export type { BackdropVariant } from './scenes.js';
+export { CAP, DENSITY, lcg, thin } from './math.js';
+export type { BackdropDensity } from './math.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backdrops/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backdrops/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/backdrops/index.js

@@ -0,0 +1,8 @@
+// @northstar-js/react/backdrops — animated star backdrops. One component,
+// fifteen interchangeable variants, all drawn from seeded maths (no
+// Math.random) in the 720 × 450 design frame and sliced to cover their
+// container. Styles ship in `backdrops.css`; load it after `tokens.css`.
+export { StarBackdrop } from './StarBackdrop.js';
+export { BACKDROP_VARIANTS, countMarks, sceneData } from './scenes.js';
+export { CAP, DENSITY, lcg, thin } from './math.js';
+//# sourceMappingURL=index.js.map

package/dist/backdrops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backdrops/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,oEAAoE;AACpE,uEAAuE;AACvE,yEAAyE;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/backdrops/math.d.ts

@@ -0,0 +1,39 @@
+/** The four-point north star on a unit box, scaled per star with `transform`. */
+export declare const STAR = "M0 -1L.2 -.2L1 0L.2 .2L0 1L-.2 .2L-1 0L-.2 -.2Z";
+/** CSS polygon of the same star, for the 3D (HTML) scenes. */
+export declare const STAR_CLIP = "polygon(50% 0,60% 40%,100% 50%,60% 60%,50% 100%,40% 60%,0 50%,40% 40%)";
+/** The design frame every scene is drawn in; the root covers its container with it (slice). */
+export declare const FRAME: {
+    readonly w: 720;
+    readonly h: 450;
+};
+/**
+ * Numerical Recipes LCG, exactly as in the approved designs:
+ * seed = (seed × 1664525 + 1013904223) mod 2³², returned as [0, 1).
+ * The products stay below 2⁵³, so the doubles are exact.
+ */
+export declare function lcg(seed: number): () => number;
+export type BackdropDensity = 'low' | 'medium' | 'high';
+/** Share of the approved element count kept at each density. `high` is the approved design. */
+export declare const DENSITY: Record<BackdropDensity, number>;
+/**
+ * Hard ceiling on drawn marks per backdrop at each density, whatever the
+ * design's own count: the share is lowered until the scene fits. `high` is
+ * set above every approved design, so it always draws the full design.
+ */
+export declare const CAP: Record<BackdropDensity, number>;
+/**
+ * Low-discrepancy thinning: keeps item i when frac(i·φ) < share, so whatever
+ * is left stays evenly spread over the field, and the same items survive on
+ * every render. Items marked `keep` (the Glacier stars, the north star) always stay.
+ */
+export declare function thin<T extends {
+    keep?: boolean;
+}>(items: T[], share: number): T[];
+/** One decimal place, as the designs print coordinates. */
+export declare const f1: (n: number) => string;
+/** Two decimal places. */
+export declare const f2: (n: number) => string;
+/** The golden angle in radians, π(3 − √5). */
+export declare const GOLDEN: number;
+//# sourceMappingURL=math.d.ts.map

package/dist/backdrops/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/backdrops/math.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,eAAO,MAAM,IAAI,oDAAoD,CAAC;AAEtE,8DAA8D;AAC9D,eAAO,MAAM,SAAS,2EAA2E,CAAC;AAElG,+FAA+F;AAC/F,eAAO,MAAM,KAAK;;;CAA8B,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CAG9C;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,+FAA+F;AAC/F,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAwC,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,GAAG,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAyC,CAAC;AAI1F;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAGjF;AAED,2DAA2D;AAC3D,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,KAAG,MAAsB,CAAC;AACtD,0BAA0B;AAC1B,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,KAAG,MAAsB,CAAC;AAEtD,8CAA8C;AAC9C,eAAO,MAAM,MAAM,QAA+B,CAAC"}

package/dist/backdrops/math.js

@@ -0,0 +1,44 @@
+// Deterministic maths for the star backdrops. Nothing here calls Math.random:
+// every scatter comes from the same linear congruential generator the approved
+// designs used, so the server, the client and every screenshot agree.
+/** The four-point north star on a unit box, scaled per star with `transform`. */
+export const STAR = 'M0 -1L.2 -.2L1 0L.2 .2L0 1L-.2 .2L-1 0L-.2 -.2Z';
+/** CSS polygon of the same star, for the 3D (HTML) scenes. */
+export const STAR_CLIP = 'polygon(50% 0,60% 40%,100% 50%,60% 60%,50% 100%,40% 60%,0 50%,40% 40%)';
+/** The design frame every scene is drawn in; the root covers its container with it (slice). */
+export const FRAME = { w: 720, h: 450 };
+/**
+ * Numerical Recipes LCG, exactly as in the approved designs:
+ * seed = (seed × 1664525 + 1013904223) mod 2³², returned as [0, 1).
+ * The products stay below 2⁵³, so the doubles are exact.
+ */
+export function lcg(seed) {
+    let s = seed;
+    return () => (s = (s * 1664525 + 1013904223) % 4294967296) / 4294967296;
+}
+/** Share of the approved element count kept at each density. `high` is the approved design. */
+export const DENSITY = { low: 0.35, medium: 0.65, high: 1 };
+/**
+ * Hard ceiling on drawn marks per backdrop at each density, whatever the
+ * design's own count: the share is lowered until the scene fits. `high` is
+ * set above every approved design, so it always draws the full design.
+ */
+export const CAP = { low: 240, medium: 480, high: 1800 };
+const PHI_FRAC = 0.6180339887498949;
+/**
+ * Low-discrepancy thinning: keeps item i when frac(i·φ) < share, so whatever
+ * is left stays evenly spread over the field, and the same items survive on
+ * every render. Items marked `keep` (the Glacier stars, the north star) always stay.
+ */
+export function thin(items, share) {
+    if (share >= 1)
+        return items;
+    return items.filter((it, i) => it.keep || (i * PHI_FRAC) % 1 < share);
+}
+/** One decimal place, as the designs print coordinates. */
+export const f1 = (n) => n.toFixed(1);
+/** Two decimal places. */
+export const f2 = (n) => n.toFixed(2);
+/** The golden angle in radians, π(3 − √5). */
+export const GOLDEN = Math.PI * (3 - Math.sqrt(5));
+//# sourceMappingURL=math.js.map

package/dist/backdrops/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/backdrops/math.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,sEAAsE;AAEtE,iFAAiF;AACjF,MAAM,CAAC,MAAM,IAAI,GAAG,iDAAiD,CAAC;AAEtE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAG,wEAAwE,CAAC;AAElG,+FAA+F;AAC/F,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAW,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AAC1E,CAAC;AAID,+FAA+F;AAC/F,MAAM,CAAC,MAAM,OAAO,GAAoC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAoC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE1F,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAA+B,KAAU,EAAE,KAAa;IAC1E,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/backdrops/scenes.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+import { type BackdropDensity } from './math.js';
+export declare const BACKDROP_VARIANTS: readonly ["constellation-atlas", "orrery", "golden-angle", "prime-lattice", "meridian-sweep", "interference", "celestial-sphere", "fibonacci-sphere", "star-torus", "double-helix", "wave-surface", "twin-vortex", "drifting-blooms", "mobius", "galaxy-3d"];
+export type BackdropVariant = (typeof BACKDROP_VARIANTS)[number];
+/** Any scene: each entry pairs a builder with the renderer for its own data shape. */
+interface AnyScene {
+    kind: '2d' | '3d';
+    build: (share: number) => unknown;
+    render: (data: never, id: string) => ReactNode;
+}
+export declare const SCENES: Record<BackdropVariant, AnyScene>;
+/** Drawn marks in a scene's data: every placed item (it has an `x` or `x1`). */
+export declare function countMarks(data: unknown): number;
+/**
+ * The geometry of one variant at one density, thinned to the density's share
+ * and capped at CAP[density] marks. Built once per process, then reused.
+ */
+export declare function sceneData(variant: BackdropVariant, density: BackdropDensity): unknown;
+export {};
+//# sourceMappingURL=scenes.d.ts.map

package/dist/backdrops/scenes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../src/backdrops/scenes.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAwD,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEvG,eAAO,MAAM,iBAAiB,8PAgBpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AA6iBjE,sFAAsF;AACtF,UAAU,QAAQ;IAChB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;CAChD;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CAgBpD,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIhD;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAUrF"}