@wzrhine/effects 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog · @wzrhine/effects
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。本包为 **Experimental**，0.x 期间 API 可能调整。
+
+## [Unreleased]
+
+## [0.2.0] - 2026-10-14
+
+### Added
+- **B9 · 展示动效接入补齐**：`OrbitalDiagram` 新增 `size`、节点 `tone`（accent / info / warning / success / neutral）与 `selected` / `selectedLabel`（选中态连同本地化读屏后缀）；`ScanSurface` 新增 `tone`、`duration`（毫秒或 `fast` / `base` / `panel` / `showcase` 预设）与 `containerType` / `overflow`（容器副作用开关）；`ArchiveReveal` 支持原生属性与 `ref` 透传、视口暂停与受控 `paused`。
+
+### Changed
+- peer `motion` 为 `^14.0.0`，本仓开发与验证版本为 14.1.0；与其余四个包同一版本线。
+  - 迁移：升级到 motion 14.1.0，并确保应用内 React 与 motion 各只有一份。
+
+## [0.1.0] - 2026-10-12
+
+首次发布。
+
+### Added
+- **M4（ADR-0004）**：`ArchiveReveal`（确定性解密、可中断、减动直接切换）、`ScanSurface`（单次扫描，减动时为静态描边）、`OrbitalDiagram`（仪器风格轨道，可选旋转）、`MotionPlayer`（Default / Slow ×0.25 / Reduced / Interrupt 四通道），以及 `EffectClock` / `useEffectTiming`。
+- 页面隐藏、离开视口、完成或卸载时停止循环；不使用 Canvas 或 WebGL。
+- **M5**：通过 `dist/` 发布 ESM 与 `.d.ts`；`./styles.css` 导出。
+- **M10（ADR-0007）**：`OrbitalDiagram` 增加 `data-lifecycle`（`idle` / `running` / `paused` / `stopped`）与 `data-paused`（`reduced` / `hidden` / `offscreen`）。`MotionPlayer` 的各通道设置 `MotionSpeed`，`@wzrhine/react` 的 MotionPresence / RhineMotionGroup / `useRhineMotion` 也随 Slow ×0.25 放慢。
+
+### Changed
+- **破坏性（声明层面，M9.5，ADR-0008）**：peer `react` / `react-dom` 收窄为 `^19.0.0`。
+- **M9.5**：含 React 运行时的模块在产物首行带 `'use client'`；`scramble` 等纯函数不带。
+- **M10**：`usePageVisible` / `useInViewport` 改为重新导出 `@wzrhine/react` 的实现，effects 与组件共用一套可见性来源；导入路径不变。
+- **M10**：所有循环改用共享生命周期。`OrbitalDiagram` 暂停（页面隐藏、离开视口）时保持当前角度、恢复时从该角度接续，而不是回到 0°；`ScanSurface` 在页面隐藏时立即结束本次扫描，隐藏期间请求的扫描不运行；`ArchiveReveal` 隐藏时冻结在当前进度。
+
+### Fixed
+- **M10**：`MotionPlayer` 的 Default / Slow / Interrupt 通道曾用 `MotionConfig reducedMotion="user"` 包裹，会把外层 `RhineProvider motion="reduce"` 或 `MotionConfig reducedMotion="always"` 重置为跟随系统，导致用户选择减少动态效果时这些通道仍有位移。现在只有 Reduced 通道强制减动，其他通道继承外层偏好。
+
+### Requirements
+- peer：`@wzrhine/react`（同版本线）、`react` / `react-dom` ^19（M9.5 起）、`motion` ^12。
+
+M6 未改动本包。升级步骤见 [UPGRADING.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/development/UPGRADING.md)。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WhiteZhi
+
+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

@@ -1,3 +1,23 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @wzrhine/effects
+
+WzRhineLab UI 的**可选**展示动效：解密、扫描、轨道，以及用于对照的四通道动效播放器。`@wzrhine/react` 不依赖本包。
+
+> 实验性（0.x 期间 API 可能调整）；MIT 许可证。
+
+```sh
+pnpm add @wzrhine/effects @wzrhine/react @wzrhine/tokens react react-dom motion
+```
+
+```tsx
+import '@wzrhine/effects/styles.css';
+import { ArchiveReveal, MotionPlayer } from '@wzrhine/effects';
+
+<MotionPlayer title="ArchiveReveal" demo={({ active }) => <ArchiveReveal text="ARC-1024" revealed={active} />} />;
+```
+
+规则：只在用户触发时播放；内容先于动画可读；减动时有等价表现；页面隐藏时暂停。
+
+- 使用说明：[docs/components/effects.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/components/effects.md)
+- API 参考（自动生成）：[docs/api/effects.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/api/effects.md)
+- 变更记录：[CHANGELOG.md](./CHANGELOG.md)
+- 许可证：[MIT](./LICENSE)

package/dist/ArchiveReveal.d.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+/**
+ * Decrypt-style reveal for short labels (IDs, titles). Showcase effect only (MOTION.md):
+ * - The real text is always in the accessibility tree; the scramble is aria-hidden decoration.
+ * - Toggling `revealed` mid-flight reverses from the current progress, never restarting.
+ * - Reduced motion (OS, provider, or EffectClock) swaps instantly with no glyph cycling.
+ * - The loop pauses while the page is hidden (shared `usePageVisible`, ADR-0007), resumes from the
+ *   current progress, and stops once settled or unmounted. It is short and one-shot, so it does not
+ *   track the viewport.
+ * Never use it to delay business data: pass content that is already loaded.
+ */
+export type ArchiveRevealProps = Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> & {
+    text: string;
+    /** Target state. Changing it animates from the current position. */
+    revealed: boolean;
+    /** Full reveal duration at speed 1 (ms). */
+    duration?: number;
+    /** Called once the effect settles at the requested state. */
+    onSettled?: (revealed: boolean) => void;
+    /** Accessible text while concealed, e.g. "受限内容". Defaults to the text itself. */
+    concealedLabel?: string;
+    paused?: boolean;
+};
+export declare const ArchiveReveal: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    text: string;
+    /** Target state. Changing it animates from the current position. */
+    revealed: boolean;
+    /** Full reveal duration at speed 1 (ms). */
+    duration?: number;
+    /** Called once the effect settles at the requested state. */
+    onSettled?: (revealed: boolean) => void;
+    /** Accessible text while concealed, e.g. "受限内容". Defaults to the text itself. */
+    concealedLabel?: string;
+    paused?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=ArchiveReveal.d.ts.map

package/dist/ArchiveReveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchiveReveal.d.ts","sourceRoot":"","sources":["../src/ArchiveReveal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;GASG;AAEH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,GAAG;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAIF,eAAO,MAAM,aAAa;UAdlB,MAAM;IACZ,oEAAoE;cAC1D,OAAO;IACjB,4CAA4C;eACjC,MAAM;IACjB,6DAA6D;gBACjD,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI;IACvC,iFAAiF;qBAChE,MAAM;aACd,OAAO;yCAiGhB,CAAC"}

package/dist/ArchiveReveal.js

@@ -0,0 +1,86 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { useEffectTiming } from './clock.js';
+import { scrambleCells, stepToward } from './scramble.js';
+import { usePageVisible } from './usePageVisible.js';
+const FRAME_MS = 48;
+export const ArchiveReveal = React.forwardRef(function ArchiveReveal({ text, revealed, duration = 640, onSettled, concealedLabel, paused = false, className, ...rest }, ref) {
+    const timing = useEffectTiming();
+    const visible = usePageVisible();
+    const viewportRef = React.useRef(null);
+    const [inViewport, setInViewport] = React.useState(true);
+    React.useEffect(() => {
+        const element = viewportRef.current;
+        if (!element)
+            return undefined;
+        const onVisibility = () => { if (!document.hidden)
+            setInViewport(true); };
+        document.addEventListener('visibilitychange', onVisibility);
+        if (typeof IntersectionObserver === 'undefined')
+            return () => document.removeEventListener('visibilitychange', onVisibility);
+        const observer = new IntersectionObserver(([entry]) => setInViewport(entry?.isIntersecting ?? false), { threshold: 0 });
+        observer.observe(element);
+        return () => { observer.disconnect(); document.removeEventListener('visibilitychange', onVisibility); };
+    }, []);
+    const effectiveVisible = visible && inViewport && !paused;
+    const target = revealed ? 1 : 0;
+    const [progress, setProgress] = React.useState(target);
+    const [frame, setFrame] = React.useState(0);
+    const progressRef = React.useRef(progress);
+    progressRef.current = progress;
+    const settledRef = React.useRef(onSettled);
+    settledRef.current = onSettled;
+    React.useEffect(() => {
+        if (timing.reduced) {
+            setProgress(target);
+            if (progressRef.current !== target)
+                settledRef.current?.(revealed);
+            return;
+        }
+        if (progressRef.current === target)
+            return;
+        if (!effectiveVisible) {
+            // Paused: settle nothing now; the effect re-runs (and resumes from the current progress) on visibility.
+            return;
+        }
+        const total = timing.scale(duration);
+        // Baseline comes from the first frame's own timestamp: rAF time and performance.now()
+        // do not share an origin in every environment.
+        let last = null;
+        let lastFrame = 0;
+        let raf = 0;
+        const tick = (now) => {
+            if (last === null) {
+                last = now;
+                lastFrame = now;
+                raf = requestAnimationFrame(tick);
+                return;
+            }
+            const dt = Math.max(0, now - last);
+            last = now;
+            const next = stepToward(progressRef.current, target, dt / total);
+            progressRef.current = next;
+            setProgress(next);
+            if (now - lastFrame >= FRAME_MS / timing.speed) {
+                lastFrame = now;
+                setFrame((f) => f + 1);
+            }
+            if (next === target) {
+                settledRef.current?.(revealed);
+                return;
+            }
+            raf = requestAnimationFrame(tick);
+        };
+        raf = requestAnimationFrame(tick);
+        return () => cancelAnimationFrame(raf);
+    }, [target, revealed, duration, timing, effectiveVisible]);
+    const cells = scrambleCells(text, progress, frame);
+    const settled = progress === target;
+    const label = revealed ? text : (concealedLabel ?? text);
+    return (_jsxs("span", { ...rest, ref: (node) => { viewportRef.current = node; if (typeof ref === 'function')
+            ref(node);
+        else if (ref)
+            ref.current = node; }, className: ['rl-reveal', className].filter(Boolean).join(' '), "data-slot": "archive-reveal", "data-state": settled ? (revealed ? 'revealed' : 'concealed') : 'animating', "data-reduced": timing.reduced || undefined, "data-paused": paused || !effectiveVisible || undefined, "aria-label": rest['aria-label'] ?? label, children: [_jsx("span", { className: "rl-effect-sr", children: label }), _jsx("span", { className: "rl-reveal__glyphs", "aria-hidden": "true", children: cells.map((cell, i) => (_jsx("span", { className: "rl-reveal__cell", "data-resolved": cell.resolved || undefined, children: cell.char }, i))) })] }));
+});
+//# sourceMappingURL=ArchiveReveal.js.map

package/dist/ArchiveReveal.js.map

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

package/dist/MotionPlayer.d.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+/**
+ * Side-by-side motion comparison (MOTION.md "Showcase 每类动画提供 Default / Slow x0.25 /
+ * Reduced / Interrupt 四组状态"). Renders the same demo in four lanes:
+ * - Default:   speed 1, inherits the surrounding motion preference (never re-enables motion).
+ * - Slow ×0.25: four times slower, for reviewing easing and choreography.
+ * - Reduced:   forced reduced motion (MotionConfig "always" + data-rl-motion), the equivalent fallback.
+ * - Interrupt: speed 1; the player re-triggers the demo while it is still running, proving the effect
+ *              retargets from its current state instead of queueing or restarting.
+ * One shared play control drives every lane, so the lanes stay in step. Lanes also set `MotionSpeed`, so
+ * @wzrhine/react motion (MotionPresence, RhineMotionGroup, useRhineMotion) slows down with effects.
+ */
+export type MotionLane = 'default' | 'slow' | 'reduced' | 'interrupt';
+export interface MotionDemoProps {
+    /** Monotonic play counter; each increment is one "play". */
+    play: number;
+    /** Target state toggled by each play (e.g. revealed / concealed). */
+    active: boolean;
+    lane: MotionLane;
+}
+export type MotionPlayerProps = {
+    /** Visible title of the comparison; also names the region. */
+    title: React.ReactNode;
+    /** One-line timing spec shown under the title, e.g. "scene 420ms · ease-in-out". */
+    spec?: React.ReactNode;
+    /** Renders one lane. Must be deterministic for a given (play, active). */
+    demo: (props: MotionDemoProps) => React.ReactNode;
+    /** Lanes to show; defaults to all four. */
+    lanes?: readonly MotionLane[];
+    /** How long after each play (ms) the Interrupt lane reverses; keep it shorter than the demo's duration. */
+    interruptAfterMs?: number;
+    /** Initial active state. */
+    defaultActive?: boolean;
+    className?: string;
+};
+export declare function MotionPlayer({ title, spec, demo, lanes, interruptAfterMs, defaultActive, className, }: MotionPlayerProps): React.JSX.Element;
+//# sourceMappingURL=MotionPlayer.d.ts.map

package/dist/MotionPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MotionPlayer.d.ts","sourceRoot":"","sources":["../src/MotionPlayer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oFAAoF;IACpF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,0EAA0E;IAC1E,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAClD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,2GAA2G;IAC3G,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAoBF,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAgB,EAChB,gBAAsB,EACtB,aAAqB,EACrB,SAAS,GACV,EAAE,iBAAiB,qBAwEnB"}

package/dist/MotionPlayer.js

@@ -0,0 +1,51 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { MotionConfig } from 'motion/react';
+import { MotionSpeed } from '@wzrhine/react';
+import { EffectClock } from './clock.js';
+const laneMeta = {
+    default: { label: 'Default', hint: '×1 · 跟随系统偏好', speed: 1, reduced: false },
+    slow: { label: 'Slow ×0.25', hint: '四倍慢放，检查缓动', speed: 0.25, reduced: false },
+    reduced: { label: 'Reduced', hint: '强制减少动态效果', speed: 1, reduced: true },
+    interrupt: { label: 'Interrupt', hint: '播放中途反向触发', speed: 1, reduced: false },
+};
+const allLanes = ['default', 'slow', 'reduced', 'interrupt'];
+/**
+ * The Reduced lane forces reduced motion. The other lanes inherit the surrounding preference
+ * (OS or RhineProvider) instead of resetting it to "user": a reader who asked for reduced motion
+ * must not get motion back inside a comparison.
+ */
+function LaneMotion({ reduced, children }) {
+    return reduced ? _jsx(MotionConfig, { reducedMotion: "always", children: children }) : _jsx(_Fragment, { children: children });
+}
+export function MotionPlayer({ title, spec, demo, lanes = allLanes, interruptAfterMs = 180, defaultActive = false, className, }) {
+    const titleId = React.useId();
+    const [play, setPlay] = React.useState(0);
+    const [active, setActive] = React.useState(defaultActive);
+    // The interrupt lane gets its own state: it follows the shared play, then reverses shortly after.
+    const [interrupt, setInterrupt] = React.useState({ play: 0, active: defaultActive });
+    const trigger = () => {
+        const next = !active;
+        setActive(next);
+        setPlay((p) => p + 1);
+        setInterrupt((s) => ({ play: s.play + 1, active: next }));
+    };
+    React.useEffect(() => {
+        if (play === 0)
+            return;
+        const t = window.setTimeout(() => setInterrupt((s) => ({ play: s.play + 1, active: !s.active })), interruptAfterMs);
+        return () => window.clearTimeout(t);
+    }, [play, interruptAfterMs]);
+    const reset = () => {
+        setActive(defaultActive);
+        setPlay(0);
+        setInterrupt({ play: 0, active: defaultActive });
+    };
+    return (_jsxs("section", { className: ['rl-player', className].filter(Boolean).join(' '), "aria-labelledby": titleId, "data-slot": "motion-player", children: [_jsxs("header", { className: "rl-player__head", children: [_jsxs("div", { className: "rl-player__titles", children: [_jsx("h3", { id: titleId, className: "rl-player__title", children: title }), spec != null && _jsx("p", { className: "rl-player__spec", children: spec })] }), _jsxs("div", { className: "rl-player__controls", children: [_jsx("button", { type: "button", className: "rl-player__button", "data-primary": true, onClick: trigger, "aria-describedby": `${titleId}-state`, children: active ? '反向播放' : '播放' }), _jsx("button", { type: "button", className: "rl-player__button", onClick: reset, disabled: play === 0, children: "\u91CD\u7F6E" }), _jsxs("span", { id: `${titleId}-state`, className: "rl-player__state", "aria-live": "polite", children: ["\u7B2C ", play, " \u6B21 \u00B7 \u76EE\u6807\uFF1A", active ? '激活' : '初始'] })] })] }), _jsx("ol", { className: "rl-player__lanes", children: lanes.map((lane) => {
+                    const meta = laneMeta[lane];
+                    const laneProps = lane === 'interrupt' ? { play: interrupt.play, active: interrupt.active, lane } : { play, active, lane };
+                    return (_jsxs("li", { className: "rl-player__lane", "data-lane": lane, children: [_jsxs("p", { className: "rl-player__lane-label", children: [_jsx("span", { children: meta.label }), _jsx("span", { className: "rl-player__lane-hint", children: meta.hint })] }), _jsx(LaneMotion, { reduced: meta.reduced, children: _jsx(MotionSpeed, { speed: meta.speed, children: _jsx(EffectClock, { speed: meta.speed, reduced: meta.reduced, children: _jsx("div", { className: "rl-player__stage", "data-rl-motion": meta.reduced ? 'reduce' : undefined, children: demo(laneProps) }) }) }) })] }, lane));
+                }) })] }));
+}
+//# sourceMappingURL=MotionPlayer.js.map

package/dist/MotionPlayer.js.map

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

package/dist/OrbitalDiagram.d.ts

@@ -0,0 +1,39 @@
+import * as React from 'react';
+/**
+ * Instrument-style orbital diagram (DESIGN.md "Instrument Accent"): concentric rings with labelled
+ * nodes. Decorative structure around real labels, not a data visualisation:
+ * - Labels are real text in an accessible list; the SVG is aria-hidden.
+ * - Rotation is opt-in (`animate`), stops when off-screen, on hidden tabs and under reduced motion
+ *   (shared lifecycle, ADR-0007); `data-lifecycle` / `data-paused` expose the current state.
+ * - Positions are fixed by `angle` props; nothing is random.
+ */
+export interface OrbitNode {
+    id: string;
+    label: string;
+    /** Ring index, 0 = innermost. */
+    ring: number;
+    /** Position on the ring in degrees, 0 = top, clockwise. */
+    angle: number;
+    /** Highlight one node (e.g. the current subject). */
+    active?: boolean;
+    selected?: boolean;
+    tone?: 'accent' | 'info' | 'warning' | 'success' | 'neutral';
+}
+export type OrbitalDiagramProps = {
+    nodes: readonly OrbitNode[];
+    size?: number;
+    rings?: number;
+    /** Centre caption, e.g. a record ID. */
+    center?: string;
+    /** Slow ambient rotation. Off by default; disabled by reduced motion. */
+    animate?: boolean;
+    /** Seconds per revolution of the outer ring at speed 1. */
+    period?: number;
+    /** Accessible name of the node list. */
+    label: string;
+    /** Localised suffix announced for a selected node. */
+    selectedLabel?: string;
+    className?: string;
+};
+export declare function OrbitalDiagram({ nodes, rings, size, center, animate, period, label, selectedLabel, className }: OrbitalDiagramProps): React.JSX.Element;
+//# sourceMappingURL=OrbitalDiagram.d.ts.map

package/dist/OrbitalDiagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitalDiagram.d.ts","sourceRoot":"","sources":["../src/OrbitalDiagram.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,KAAS,EAAE,IAAW,EAAE,MAAM,EAAE,OAAe,EAAE,MAAW,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,mBAAmB,qBA4E3J"}

package/dist/OrbitalDiagram.js

@@ -0,0 +1,43 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { animate as animateValue, motion, useMotionValue } from 'motion/react';
+import { useMotionLifecycle, useRhineLocale } from '@wzrhine/react';
+import { useEffectTiming } from './clock.js';
+const SIZE = 240;
+export function OrbitalDiagram({ nodes, rings = 3, size = SIZE, center, animate = false, period = 60, label, selectedLabel, className }) {
+    const { locale } = useRhineLocale();
+    const selectedText = selectedLabel ?? (locale.toLowerCase().startsWith('en') ? 'selected' : '当前');
+    const timing = useEffectTiming();
+    const ref = React.useRef(null);
+    const lifecycle = useMotionLifecycle({ active: animate, viewportRef: ref, reduced: timing.reduced });
+    const spinning = lifecycle.running;
+    const rotate = useMotionValue(0);
+    const revolution = period / timing.speed;
+    // Running: continue from the current angle. Paused (hidden, off-screen, reduced): hold the angle.
+    // Stopped or never started: back to the rest position.
+    React.useEffect(() => {
+        if (!spinning) {
+            if (lifecycle.state !== 'paused' || timing.reduced)
+                rotate.jump(0);
+            return;
+        }
+        const from = rotate.get() % 360;
+        const controls = animateValue(rotate, [from, from + 360], { duration: revolution, ease: 'linear', repeat: Infinity });
+        return () => controls.stop();
+    }, [spinning, revolution, lifecycle.state, timing.reduced, rotate]);
+    const viewSize = Math.max(96, size);
+    const centerPoint = viewSize / 2;
+    const radius = (ring) => 36 * (viewSize / SIZE) + (ring * (centerPoint - 48 * (viewSize / SIZE))) / Math.max(1, rings - 1);
+    return (_jsx("div", { className: "rl-orbit-wrap", children: _jsxs("div", { ref: ref, className: ['rl-orbit', className].filter(Boolean).join(' '), "data-slot": "orbital-diagram", "data-size": size, "data-spinning": spinning || undefined, "data-lifecycle": lifecycle.state, "data-paused": lifecycle.pauseReason ?? undefined, children: [_jsxs("svg", { className: "rl-orbit__svg", viewBox: `0 0 ${viewSize} ${viewSize}`, "aria-hidden": "true", focusable: "false", children: [_jsx("g", { className: "rl-orbit__ticks", children: Array.from({ length: 24 }, (_, i) => {
+                                const a = (i * 15 * Math.PI) / 180;
+                                const r1 = centerPoint - 6;
+                                const r2 = i % 6 === 0 ? centerPoint - 14 : centerPoint - 10;
+                                return _jsx("line", { x1: centerPoint + r1 * Math.sin(a), y1: centerPoint - r1 * Math.cos(a), x2: centerPoint + r2 * Math.sin(a), y2: centerPoint - r2 * Math.cos(a) }, i);
+                            }) }), _jsxs(motion.g, { className: "rl-orbit__rotor", style: { transformOrigin: `${centerPoint}px ${centerPoint}px`, rotate }, children: [Array.from({ length: rings }, (_, ring) => (_jsx("circle", { className: "rl-orbit__ring", cx: centerPoint, cy: centerPoint, r: radius(ring), "data-ring": ring }, ring))), nodes.map((node) => {
+                                    const a = (node.angle * Math.PI) / 180;
+                                    const r = radius(Math.min(node.ring, rings - 1));
+                                    return (_jsx("circle", { className: "rl-orbit__node", "data-active": node.active || undefined, "data-selected": node.selected || undefined, "data-tone": node.tone ?? undefined, cx: centerPoint + r * Math.sin(a), cy: centerPoint - r * Math.cos(a), r: node.active ? 5 : 3.5 }, node.id));
+                                })] }), _jsx("circle", { className: "rl-orbit__core", cx: centerPoint, cy: centerPoint, r: 14 * (viewSize / SIZE) }), _jsx("path", { className: "rl-orbit__crosshair", d: `M${centerPoint - 22 * (viewSize / SIZE)} ${centerPoint}h${8 * (viewSize / SIZE)}M${centerPoint + 14 * (viewSize / SIZE)} ${centerPoint}h${8 * (viewSize / SIZE)}M${centerPoint} ${centerPoint - 22 * (viewSize / SIZE)}v${8 * (viewSize / SIZE)}M${centerPoint} ${centerPoint + 14 * (viewSize / SIZE)}v${8 * (viewSize / SIZE)}` })] }), center && _jsx("span", { className: "rl-orbit__center", children: center }), _jsx("ul", { className: "rl-orbit__legend", "aria-label": label, children: nodes.map((node) => (_jsxs("li", { "data-active": node.active || undefined, "data-selected": node.selected || undefined, children: [_jsxs("span", { className: "rl-orbit__ring-index", "aria-hidden": "true", children: ["R", node.ring + 1] }), node.label, (node.active || node.selected) && _jsxs("span", { className: "rl-effect-sr", children: ["(", selectedText, ")"] })] }, node.id))) })] }) }));
+}
+//# sourceMappingURL=OrbitalDiagram.js.map

package/dist/OrbitalDiagram.js.map

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

package/dist/ScanSurface.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+/**
+ * Single-pass scan line over a surface, triggered by the user (e.g. "re-scan"). Showcase effect:
+ * - One sweep per `scanKey` change, never an idle infinite loop (STYLE.md forbids default infinite scans).
+ * - Children render immediately and stay interactive; the sweep is a pointer-events:none overlay.
+ * - Reduced motion: no moving line; a brief static outline marks the "scanned" moment instead.
+ * - Stop conditions (ADR-0007): skipped while the page is hidden, cut short if the page hides mid-sweep,
+ *   cleared on unmount. One-shot, so it does not track the viewport.
+ */
+export type ScanSurfaceProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> & {
+    children: React.ReactNode;
+    /** Change this value to run one sweep (a counter or timestamp). */
+    scanKey?: number | string;
+    /** Sweep duration at speed 1 (ms). */
+    duration?: number | 'fast' | 'base' | 'panel' | 'showcase';
+    tone?: 'accent' | 'info' | 'warning' | 'success' | 'neutral';
+    overflow?: 'hidden' | 'visible';
+    containerType?: boolean;
+    onScanEnd?: () => void;
+    className?: string;
+};
+export declare function ScanSurface({ children, scanKey, duration, onScanEnd, tone, overflow, containerType, className, ...rest }: ScanSurfaceProps): React.JSX.Element;
+//# sourceMappingURL=ScanSurface.d.ts.map

package/dist/ScanSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScanSurface.d.ts","sourceRoot":"","sources":["../src/ScanSurface.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IACtF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC3D,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAqB,EAAE,SAAS,EAAE,IAAe,EAAE,QAAmB,EAAE,aAAoB,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,qBAsDpL"}

package/dist/ScanSurface.js

@@ -0,0 +1,43 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { useEffectTiming } from './clock.js';
+import { usePageVisible } from './usePageVisible.js';
+const DURATIONS = { fast: 120, base: 200, panel: 280, showcase: 700 };
+export function ScanSurface({ children, scanKey, duration = 'showcase', onScanEnd, tone = 'accent', overflow = 'hidden', containerType = true, className, ...rest }) {
+    const durationMs = typeof duration === 'number' ? duration : DURATIONS[duration];
+    const timing = useEffectTiming();
+    const visible = usePageVisible();
+    const [running, setRunning] = React.useState(false);
+    const lastKey = React.useRef(scanKey);
+    const timer = React.useRef(undefined);
+    const latest = React.useRef({ visible, reduced: timing.reduced, ms: timing.scale(durationMs), onScanEnd });
+    latest.current = { visible, reduced: timing.reduced, ms: timing.scale(durationMs), onScanEnd };
+    // Only a change of scanKey starts a sweep; other prop changes must not retrigger it.
+    React.useEffect(() => {
+        if (Object.is(lastKey.current, scanKey))
+            return;
+        lastKey.current = scanKey;
+        const { visible: isVisible, reduced, ms } = latest.current;
+        if (scanKey === undefined || !isVisible)
+            return;
+        setRunning(true);
+        const t = window.setTimeout(() => {
+            setRunning(false);
+            latest.current.onScanEnd?.();
+        }, reduced ? 160 : ms);
+        timer.current = t;
+        return () => window.clearTimeout(t);
+    }, [scanKey]);
+    // Hidden mid-sweep: end it now instead of finishing off-screen.
+    React.useEffect(() => {
+        if (visible || !running)
+            return;
+        window.clearTimeout(timer.current);
+        setRunning(false);
+        latest.current.onScanEnd?.();
+    }, [visible, running]);
+    const style = { '--rl-scan-duration': `${timing.scale(durationMs)}ms` };
+    return (_jsxs("div", { ...rest, className: ['rl-scan', className].filter(Boolean).join(' '), "data-slot": "scan-surface", "data-scanning": running || undefined, "data-reduced": timing.reduced || undefined, "data-tone": tone, "data-container-type": containerType ? 'inline-size' : 'none', "data-overflow": overflow, style: style, children: [children, running && _jsx("span", { className: "rl-scan__line", "aria-hidden": "true" }, String(scanKey))] }));
+}
+//# sourceMappingURL=ScanSurface.js.map

package/dist/ScanSurface.js.map

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

package/dist/clock.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+export interface EffectClockProps {
+    speed?: number;
+    reduced?: boolean;
+    children: React.ReactNode;
+}
+export declare function EffectClock({ speed, reduced, children }: EffectClockProps): React.JSX.Element;
+export interface EffectTiming {
+    speed: number;
+    reduced: boolean;
+    /** Scale a base duration (ms) by the current speed. */
+    scale: (ms: number) => number;
+}
+export declare function useEffectTiming(): EffectTiming;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAS,EAAE,OAAe,EAAE,QAAQ,EAAE,EAAE,gBAAgB,qBAGrF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B;AAED,wBAAgB,eAAe,IAAI,YAAY,CAO9C"}

package/dist/clock.js

@@ -0,0 +1,15 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+import { useRhineMotion } from '@wzrhine/react';
+const EffectClockContext = React.createContext({ speed: 1, forceReduced: false });
+export function EffectClock({ speed = 1, reduced = false, children }) {
+    const value = React.useMemo(() => ({ speed: speed > 0 ? speed : 1, forceReduced: reduced }), [speed, reduced]);
+    return _jsx(EffectClockContext.Provider, { value: value, children: children });
+}
+export function useEffectTiming() {
+    const { speed, forceReduced } = React.useContext(EffectClockContext);
+    const { reduced } = useRhineMotion();
+    return React.useMemo(() => ({ speed, reduced: forceReduced || reduced, scale: (ms) => ms / speed }), [speed, forceReduced, reduced]);
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAYhD,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAQpG,MAAM,UAAU,WAAW,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAoB;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/G,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA+B,CAAC;AAC7F,CAAC;AASD,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACrE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,EACtF,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAC/B,CAAC;AACJ,CAAC"}

package/dist/effects.css

@@ -0,0 +1,367 @@
+/*
+ * WzRhineLab UI · optional showcase effects (M4). Tokens only; requires a `.rl-theme` ancestor.
+ * Every animation here has a reduced-motion equivalent (asserted by tests).
+ */
+
+.rl-effect-sr {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: var(--rl-border-width);
+  height: var(--rl-border-width);
+  margin: calc(var(--rl-border-width) * -1);
+  padding: 0;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* ---------- ArchiveReveal ---------- */
+.rl-reveal {
+  position: relative;
+  display: inline-block;
+  max-width: 100%;
+  font-family: var(--rl-font-mono);
+  letter-spacing: var(--rl-tracking-mono);
+  font-variant-numeric: tabular-nums;
+}
+
+.rl-reveal__glyphs {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}
+
+.rl-reveal__cell {
+  color: var(--rl-fg-subtle);
+  transition: color var(--rl-motion-fast) var(--rl-ease-out);
+}
+
+.rl-reveal__cell[data-resolved] {
+  color: inherit;
+}
+
+.rl-reveal[data-state='concealed'] .rl-reveal__cell {
+  color: var(--rl-fg-subtle);
+}
+
+/* ---------- ScanSurface ---------- */
+.rl-scan {
+  position: relative;
+  overflow: hidden;
+  isolation: isolate;
+}
+
+.rl-scan[data-overflow='visible'] { overflow: visible; }
+
+.rl-scan__line {
+  position: absolute;
+  inset: 0 auto 0 0;
+  z-index: 1;
+  width: var(--rl-space-16);
+  pointer-events: none;
+  background: linear-gradient(
+    to right,
+    transparent,
+    color-mix(in srgb, var(--rl-accent) 14%, transparent) 70%,
+    var(--rl-scan-tone, var(--rl-accent)) calc(100% - var(--rl-border-width)),
+    transparent 100%
+  );
+  translate: -100% 0;
+  animation: rl-scan-sweep var(--rl-scan-duration) var(--rl-ease-in-out) 1 forwards;
+}
+
+@keyframes rl-scan-sweep {
+  to {
+    translate: calc(100% + 100cqw) 0;
+  }
+}
+
+.rl-scan {
+  container-type: inline-size;
+}
+.rl-scan[data-container-type='none'] { container-type: normal; }
+.rl-scan[data-tone='info'] { --rl-scan-tone: var(--rl-info); }
+.rl-scan[data-tone='warning'] { --rl-scan-tone: var(--rl-warning); }
+.rl-scan[data-tone='success'] { --rl-scan-tone: var(--rl-success); }
+.rl-scan[data-tone='neutral'] { --rl-scan-tone: var(--rl-fg-muted); }
+
+/* Reduced motion: no travelling line; a brief static outline marks the scan instead. */
+.rl-scan[data-reduced] .rl-scan__line,
+.rl-theme[data-rl-motion='reduce'] .rl-scan__line {
+  inset: 0;
+  width: auto;
+  background: none;
+  box-shadow: inset 0 0 0 var(--rl-border-width-strong) var(--rl-accent);
+  translate: none;
+  animation: none;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .rl-scan__line {
+    inset: 0;
+    width: auto;
+    background: none;
+    box-shadow: inset 0 0 0 var(--rl-border-width-strong) var(--rl-accent);
+    translate: none;
+    animation: none;
+  }
+}
+
+/* ---------- OrbitalDiagram ---------- */
+/* Diagram and legend sit side by side; the legend wraps below only when its column would be too
+   narrow to hold a label on one line (container query on the diagram's own width). */
+.rl-orbit-wrap {
+  container-type: inline-size;
+  min-width: 0;
+}
+
+.rl-orbit {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  align-items: center;
+  gap: var(--rl-space-6);
+  min-width: 0;
+}
+
+@container (min-width: 400px) {
+  .rl-orbit {
+    grid-template-columns: minmax(0, var(--rl-orbit-size)) minmax(0, 1fr);
+  }
+}
+
+.rl-orbit__svg {
+  grid-column: 1;
+  grid-row: 1;
+  justify-self: center;
+  width: 100%;
+  max-width: var(--rl-orbit-size);
+  height: auto;
+  overflow: visible;
+}
+
+.rl-orbit__center {
+  grid-column: 1;
+  grid-row: 1;
+  justify-self: center;
+  align-self: center;
+  translate: 0 calc(var(--rl-space-8) + var(--rl-space-2));
+  font: var(--rl-type-mono);
+  letter-spacing: var(--rl-tracking-caps);
+  color: var(--rl-fg-muted);
+}
+
+.rl-orbit__ticks line {
+  stroke: var(--rl-border-default);
+  stroke-width: var(--rl-border-width);
+}
+
+.rl-orbit__ring {
+  fill: none;
+  stroke: var(--rl-border-default);
+  stroke-width: var(--rl-border-width);
+}
+
+.rl-orbit__ring[data-ring='0'] {
+  stroke-dasharray: 2 4;
+}
+
+.rl-orbit__node {
+  fill: var(--rl-bg-surface);
+  stroke: var(--rl-fg-muted);
+  stroke-width: var(--rl-border-width-strong);
+}
+
+.rl-orbit__node[data-active] {
+  fill: var(--rl-accent);
+  stroke: var(--rl-accent);
+}
+.rl-orbit__node[data-selected] { stroke: var(--rl-fg-primary); stroke-width: var(--rl-border-width-strong); }
+.rl-orbit__node[data-tone='info'] { fill: var(--rl-info-subtle); stroke: var(--rl-info); }
+.rl-orbit__node[data-tone='warning'] { fill: var(--rl-warning-subtle); stroke: var(--rl-warning); }
+.rl-orbit__node[data-tone='success'] { fill: var(--rl-success-subtle); stroke: var(--rl-success); }
+.rl-orbit__node[data-tone='neutral'] { fill: var(--rl-bg-subtle); stroke: var(--rl-fg-muted); }
+
+.rl-orbit__core {
+  fill: var(--rl-bg-subtle);
+  stroke: var(--rl-fg-primary);
+  stroke-width: var(--rl-border-width);
+}
+
+.rl-orbit__crosshair {
+  stroke: var(--rl-fg-primary);
+  stroke-width: var(--rl-border-width);
+}
+
+.rl-orbit__legend {
+  display: grid;
+  gap: var(--rl-space-2);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font: var(--rl-type-body-sm);
+}
+
+.rl-orbit__legend li {
+  display: flex;
+  min-width: 0;
+  align-items: baseline;
+  gap: var(--rl-space-3);
+  padding-bottom: var(--rl-space-2);
+  border-bottom: var(--rl-border-width) solid var(--rl-border-subtle);
+}
+
+.rl-orbit__legend li[data-active] {
+  font-weight: 600;
+}
+.rl-orbit__legend li[data-selected] { text-decoration: underline; text-decoration-color: var(--rl-accent); text-underline-offset: var(--rl-space-1); }
+
+.rl-orbit__ring-index {
+  font: var(--rl-type-mono);
+  color: var(--rl-fg-subtle);
+}
+
+.rl-orbit__legend li[data-active] .rl-orbit__ring-index {
+  color: var(--rl-accent-text);
+}
+
+/* ---------- MotionPlayer ---------- */
+.rl-player {
+  display: grid;
+  gap: var(--rl-space-4);
+  min-width: 0;
+}
+
+.rl-player__head {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-end;
+  justify-content: space-between;
+  gap: var(--rl-space-3) var(--rl-space-6);
+}
+
+.rl-player__titles {
+  display: grid;
+  gap: var(--rl-space-1);
+}
+
+.rl-player__title {
+  margin: 0;
+  font: var(--rl-type-label);
+}
+
+.rl-player__spec {
+  margin: 0;
+  font: var(--rl-type-mono);
+  letter-spacing: var(--rl-tracking-mono);
+  color: var(--rl-fg-muted);
+}
+
+.rl-player__controls {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--rl-space-2);
+}
+
+.rl-player__button {
+  min-height: var(--rl-control-height-sm);
+  padding: 0 var(--rl-control-padding-x-sm);
+  appearance: none;
+  border: var(--rl-border-width) solid var(--rl-border-strong);
+  border-radius: var(--rl-radius-sm);
+  background: var(--rl-bg-surface);
+  color: var(--rl-fg-primary);
+  font: var(--rl-type-label-sm);
+  cursor: pointer;
+}
+
+.rl-player__button[data-primary] {
+  border-color: var(--rl-bg-inverse);
+  background: var(--rl-bg-inverse);
+  color: var(--rl-fg-inverse);
+}
+
+.rl-player__button:disabled {
+  border-color: var(--rl-border-default);
+  background: var(--rl-bg-disabled);
+  color: var(--rl-fg-disabled);
+  cursor: not-allowed;
+}
+
+.rl-player__button:focus-visible {
+  outline: var(--rl-focus-ring);
+  outline-offset: var(--rl-focus-offset);
+}
+
+.rl-player__state {
+  font: var(--rl-type-mono);
+  color: var(--rl-fg-subtle);
+}
+
+/* Lanes: 4 → 2 → 1 columns, never 3 + 1. Driven by the player's own width (container query).
+   Thresholds are the readable lane minimum (~200px) × columns + gaps. */
+.rl-player {
+  container-type: inline-size;
+}
+
+.rl-player__lanes {
+  --rl-lane-gap: var(--rl-space-3);
+
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: var(--rl-lane-gap);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+@container (min-width: 420px) {
+  .rl-player__lanes { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+
+@container (min-width: 840px) {
+  .rl-player__lanes { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+}
+
+.rl-player__lane {
+  display: grid;
+  grid-template-rows: auto 1fr;
+  gap: var(--rl-space-2);
+  min-width: 0;
+  padding: var(--rl-space-3);
+  border: var(--rl-border-width) solid var(--rl-border-subtle);
+  border-radius: var(--rl-radius-xs);
+  background: var(--rl-bg-canvas);
+}
+
+.rl-player__lane-label {
+  display: grid;
+  gap: var(--rl-space-1);
+  margin: 0;
+  font: var(--rl-type-mono);
+  letter-spacing: var(--rl-tracking-caps);
+  text-transform: uppercase;
+  color: var(--rl-accent-text);
+}
+
+.rl-player__lane-hint {
+  font: var(--rl-type-meta);
+  letter-spacing: 0;
+  text-transform: none;
+  color: var(--rl-fg-muted);
+}
+
+.rl-player__stage {
+  display: grid;
+  align-content: center;
+  min-height: var(--rl-space-16);
+  min-width: 0;
+}
+
+@media (forced-colors: active) {
+  .rl-scan__line { background: none; box-shadow: inset 0 0 0 var(--rl-border-width-strong) Highlight; }
+  .rl-orbit__ring, .rl-orbit__ticks line, .rl-orbit__crosshair { stroke: CanvasText; }
+  .rl-orbit__node[data-active] { fill: Highlight; stroke: Highlight; }
+  .rl-player__lane { border-color: CanvasText; }
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { ArchiveReveal } from './ArchiveReveal.js';
+export type { ArchiveRevealProps } from './ArchiveReveal.js';
+export { ScanSurface } from './ScanSurface.js';
+export type { ScanSurfaceProps } from './ScanSurface.js';
+export { OrbitalDiagram } from './OrbitalDiagram.js';
+export type { OrbitalDiagramProps, OrbitNode } from './OrbitalDiagram.js';
+export { MotionPlayer } from './MotionPlayer.js';
+export type { MotionDemoProps, MotionLane, MotionPlayerProps } from './MotionPlayer.js';
+export { EffectClock, useEffectTiming } from './clock.js';
+export type { EffectClockProps, EffectTiming } from './clock.js';
+export { isWide, isWideGlyph, maskText, scrambleCells, scrambleText, stepToward } from './scramble.js';
+export type { ScrambleCell } from './scramble.js';
+export { useInViewport, usePageVisible } from './usePageVisible.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvG,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// Optional showcase effects. Import styles from `@wzrhine/effects/styles.css`.
+// Kept out of @wzrhine/react so base components never pull in effect code (ARCHITECTURE.md).
+export { ArchiveReveal } from './ArchiveReveal.js';
+export { ScanSurface } from './ScanSurface.js';
+export { OrbitalDiagram } from './OrbitalDiagram.js';
+export { MotionPlayer } from './MotionPlayer.js';
+export { EffectClock, useEffectTiming } from './clock.js';
+export { isWide, isWideGlyph, maskText, scrambleCells, scrambleText, stepToward } from './scramble.js';
+export { useInViewport, usePageVisible } from './usePageVisible.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6FAA6F;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/scramble.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Deterministic glyph scramble for the decrypt-style reveal. The same (text, progress, frame)
+ * always yields the same output, so tests and screenshots are stable; nothing here is random.
+ */
+/** CJK and other full-width characters get full-width glyphs so the line does not reflow. */
+export declare function isWide(ch: string): boolean;
+/** True for glyphs drawn from the full-width scramble set. */
+export declare function isWideGlyph(ch: string): boolean;
+/** Static mask shown while content is concealed. */
+export declare function maskText(text: string): string;
+export interface ScrambleCell {
+    char: string;
+    resolved: boolean;
+}
+/**
+ * Characters resolve left to right as progress goes 0 → 1; unresolved positions cycle through
+ * glyphs as `frame` advances. progress ≥ 1 returns the text; progress ≤ 0 returns the mask.
+ */
+export declare function scrambleCells(text: string, progress: number, frame: number): ScrambleCell[];
+export declare function scrambleText(text: string, progress: number, frame: number): string;
+/** Move `current` toward `target` by `step` without overshooting. */
+export declare function stepToward(current: number, target: number, step: number): number;
+//# sourceMappingURL=scramble.d.ts.map

package/dist/scramble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scramble.d.ts","sourceRoot":"","sources":["../src/scramble.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG1C;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AAMD,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAW3F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhF"}

package/dist/scramble.js

@@ -0,0 +1,58 @@
+/**
+ * Deterministic glyph scramble for the decrypt-style reveal. The same (text, progress, frame)
+ * always yields the same output, so tests and screenshots are stable; nothing here is random.
+ */
+const NARROW = '0123456789ABCDEFGHJKLMNPRSTUVWXYZ#/-';
+const WIDE = '▓▒░▚▞';
+/** CJK and other full-width characters get full-width glyphs so the line does not reflow. */
+export function isWide(ch) {
+    const code = ch.codePointAt(0) ?? 0;
+    return code >= 0x2e80;
+}
+/** True for glyphs drawn from the full-width scramble set. */
+export function isWideGlyph(ch) {
+    return WIDE.includes(ch);
+}
+function isBlank(ch) {
+    return /\s/.test(ch);
+}
+/** Static mask shown while content is concealed. */
+export function maskText(text) {
+    return Array.from(text)
+        .map((ch) => (isBlank(ch) ? ch : isWide(ch) ? '▒' : '·'))
+        .join('');
+}
+/**
+ * Characters resolve left to right as progress goes 0 → 1; unresolved positions cycle through
+ * glyphs as `frame` advances. progress ≥ 1 returns the text; progress ≤ 0 returns the mask.
+ */
+export function scrambleCells(text, progress, frame) {
+    const chars = Array.from(text);
+    const n = chars.length;
+    if (progress >= 1)
+        return chars.map((char) => ({ char, resolved: true }));
+    if (progress <= 0)
+        return Array.from(maskText(text)).map((char) => ({ char, resolved: false }));
+    return chars.map((ch, i) => {
+        if (isBlank(ch))
+            return { char: ch, resolved: true };
+        if (progress >= (i + 1) / n)
+            return { char: ch, resolved: true };
+        const set = isWide(ch) ? WIDE : NARROW;
+        return { char: set[(i * 7 + frame * 13) % set.length], resolved: false };
+    });
+}
+export function scrambleText(text, progress, frame) {
+    return scrambleCells(text, progress, frame)
+        .map((cell) => cell.char)
+        .join('');
+}
+/** Move `current` toward `target` by `step` without overshooting. */
+export function stepToward(current, target, step) {
+    if (current < target)
+        return Math.min(target, current + step);
+    if (current > target)
+        return Math.max(target, current - step);
+    return current;
+}
+//# sourceMappingURL=scramble.js.map

package/dist/scramble.js.map

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

package/dist/usePageVisible.d.ts

@@ -0,0 +1,2 @@
+export { useInViewport, usePageVisible } from '@wzrhine/react';
+//# sourceMappingURL=usePageVisible.d.ts.map

package/dist/usePageVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageVisible.d.ts","sourceRoot":"","sources":["../src/usePageVisible.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/usePageVisible.js

@@ -0,0 +1,4 @@
+// Visibility hooks live in @wzrhine/react (single source, ADR-0007); re-exported here so the
+// effects public API is unchanged.
+export { useInViewport, usePageVisible } from '@wzrhine/react';
+//# sourceMappingURL=usePageVisible.js.map

package/dist/usePageVisible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageVisible.js","sourceRoot":"","sources":["../src/usePageVisible.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@wzrhine/effects",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "Optional showcase effects (decrypt reveal, scan, orbit) and a four-lane motion player for WzRhineLab UI.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BaiZhi967/WzRhineLab-UI.git",
+    "directory": "packages/effects"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./styles.css": "./dist/effects.css",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "motion": "^14.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@wzrhine/react": "^0.2.0"
+  },
+  "dependencies": {
+    "@wzrhine/tokens": "0.2.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "10.4.2",
+    "@testing-library/jest-dom": "7.0.1",
+    "@testing-library/react": "16.3.3",
+    "@testing-library/user-event": "14.6.7",
+    "@types/node": "24.19.1",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "27.4.0",
+    "motion": "^14.1.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "typescript": "^5.9.0",
+    "vitest": "4.1.11",
+    "@wzrhine/react": "0.2.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "build": "node ../../scripts/build-package.mjs"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }