@elyri/motion 0.0.0-stage → 0.0.1

package/dist/core.d.cts

@@ -0,0 +1,77 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type ColorScheme = 'light' | 'dark';
+/**
+ * 跟随页面主题实时切换明暗：主题由页面（<html data-theme> 或 .dark/.light）决定，
+ * 组件只做镜像，不读取系统偏好。
+ */
+declare function useColorScheme(): ColorScheme;
+
+interface ReducedMotionProviderProps {
+    /** true 时子树内的动画只呈现静止状态，false 强制播放 */
+    reduced: boolean;
+    children: ReactNode;
+}
+/**
+ * 在不改动系统设置的前提下，强制某棵子树播放或静止。
+ * 子树内的动画都读取该值，优先级高于系统偏好。
+ */
+declare function ReducedMotionProvider({ reduced, children }: ReducedMotionProviderProps): react.JSX.Element;
+declare function usePrefersReducedMotion(): boolean;
+
+interface ShaderFrame {
+    gl: WebGLRenderingContext;
+    /** 按名称取 uniform 位置（带缓存） */
+    uniform: (name: string) => WebGLUniformLocation | null;
+    /** 当前使用的设备像素比 */
+    dpr: number;
+}
+interface ShaderCanvasOptions {
+    /**
+     * 全屏片元着色器。每帧自动写入：
+     * - uResolution：画布尺寸（设备像素）
+     * - uTime：累计动画时间（秒，已乘 speed）
+     * - uPointer：平滑后的指针位置（设备像素，原点左上）；无指针时沿轨迹缓慢游走
+     */
+    fragmentShader: string;
+    /** 每次绘制前写入组件自定义的 uniform */
+    onDraw?: (frame: ShaderFrame) => void;
+    speed?: number;
+    interactive?: boolean;
+    /** 减弱动态效果时停留的时间点 */
+    stillTime?: number;
+    /** 内部渲染分辨率上限（设备像素比），默认 2；重着色器可调低以省填充率 */
+    maxDpr?: number;
+}
+/**
+ * 把一个全屏片元着色器渲染到 canvas 上：负责尺寸与 DPR、指针跟随、
+ * 离屏/后台暂停，以及减弱动态效果时只绘制静止帧。
+ */
+declare function useShaderCanvas(options: ShaderCanvasOptions): react.RefObject<HTMLCanvasElement | null>;
+
+type ClassValue = string | number | null | undefined | false | ClassValue[];
+declare function cn(...values: ClassValue[]): string;
+
+type LinearRgb = [number, number, number];
+/** hex（#rgb / #rrggbb）转线性空间 RGB，供着色器在线性空间计算光照 */
+declare function hexToLinearRgb(hex: string): LinearRgb;
+
+type SplitTextBy = 'char' | 'word';
+interface SplitTextUnit {
+    char: string;
+    index: number;
+}
+type SplitTextSegment = {
+    kind: 'space';
+    key: string;
+    value: string;
+} | {
+    kind: 'word';
+    key: string;
+    units: SplitTextUnit[];
+};
+/** 按空白切分文本，保留空白片段，并为每个动画单元分配全局序号 */
+declare const splitTextUnits: (text: string, by: SplitTextBy) => SplitTextSegment[];
+
+export { type ClassValue, type ColorScheme, type LinearRgb, ReducedMotionProvider, type ReducedMotionProviderProps, type ShaderCanvasOptions, type ShaderFrame, type SplitTextBy, type SplitTextSegment, type SplitTextUnit, cn, hexToLinearRgb, splitTextUnits, useColorScheme, usePrefersReducedMotion, useShaderCanvas };

package/dist/core.d.ts

@@ -0,0 +1,77 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type ColorScheme = 'light' | 'dark';
+/**
+ * 跟随页面主题实时切换明暗：主题由页面（<html data-theme> 或 .dark/.light）决定，
+ * 组件只做镜像，不读取系统偏好。
+ */
+declare function useColorScheme(): ColorScheme;
+
+interface ReducedMotionProviderProps {
+    /** true 时子树内的动画只呈现静止状态，false 强制播放 */
+    reduced: boolean;
+    children: ReactNode;
+}
+/**
+ * 在不改动系统设置的前提下，强制某棵子树播放或静止。
+ * 子树内的动画都读取该值，优先级高于系统偏好。
+ */
+declare function ReducedMotionProvider({ reduced, children }: ReducedMotionProviderProps): react.JSX.Element;
+declare function usePrefersReducedMotion(): boolean;
+
+interface ShaderFrame {
+    gl: WebGLRenderingContext;
+    /** 按名称取 uniform 位置（带缓存） */
+    uniform: (name: string) => WebGLUniformLocation | null;
+    /** 当前使用的设备像素比 */
+    dpr: number;
+}
+interface ShaderCanvasOptions {
+    /**
+     * 全屏片元着色器。每帧自动写入：
+     * - uResolution：画布尺寸（设备像素）
+     * - uTime：累计动画时间（秒，已乘 speed）
+     * - uPointer：平滑后的指针位置（设备像素，原点左上）；无指针时沿轨迹缓慢游走
+     */
+    fragmentShader: string;
+    /** 每次绘制前写入组件自定义的 uniform */
+    onDraw?: (frame: ShaderFrame) => void;
+    speed?: number;
+    interactive?: boolean;
+    /** 减弱动态效果时停留的时间点 */
+    stillTime?: number;
+    /** 内部渲染分辨率上限（设备像素比），默认 2；重着色器可调低以省填充率 */
+    maxDpr?: number;
+}
+/**
+ * 把一个全屏片元着色器渲染到 canvas 上：负责尺寸与 DPR、指针跟随、
+ * 离屏/后台暂停，以及减弱动态效果时只绘制静止帧。
+ */
+declare function useShaderCanvas(options: ShaderCanvasOptions): react.RefObject<HTMLCanvasElement | null>;
+
+type ClassValue = string | number | null | undefined | false | ClassValue[];
+declare function cn(...values: ClassValue[]): string;
+
+type LinearRgb = [number, number, number];
+/** hex（#rgb / #rrggbb）转线性空间 RGB，供着色器在线性空间计算光照 */
+declare function hexToLinearRgb(hex: string): LinearRgb;
+
+type SplitTextBy = 'char' | 'word';
+interface SplitTextUnit {
+    char: string;
+    index: number;
+}
+type SplitTextSegment = {
+    kind: 'space';
+    key: string;
+    value: string;
+} | {
+    kind: 'word';
+    key: string;
+    units: SplitTextUnit[];
+};
+/** 按空白切分文本，保留空白片段，并为每个动画单元分配全局序号 */
+declare const splitTextUnits: (text: string, by: SplitTextBy) => SplitTextSegment[];
+
+export { type ClassValue, type ColorScheme, type LinearRgb, ReducedMotionProvider, type ReducedMotionProviderProps, type ShaderCanvasOptions, type ShaderFrame, type SplitTextBy, type SplitTextSegment, type SplitTextUnit, cn, hexToLinearRgb, splitTextUnits, useColorScheme, usePrefersReducedMotion, useShaderCanvas };

package/dist/core.js

@@ -0,0 +1,3 @@
+export { ReducedMotionProvider, cn, hexToLinearRgb, splitTextUnits, useColorScheme, usePrefersReducedMotion, useShaderCanvas } from './chunk-A7JCTGZO.js';
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js"}