@cos-design/spring-mass 3.6.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. package/dist/core/index.d.ts +1 -0
  2. package/dist/core/index.js +154 -0
  3. package/dist/core/packages/shared/src/canvas-box.d.ts +18 -0
  4. package/dist/core/packages/shared/src/host-layout.d.ts +22 -0
  5. package/dist/core/packages/shared/src/index.d.ts +11 -0
  6. package/dist/core/packages/shared/src/math.d.ts +2 -0
  7. package/dist/core/packages/shared/src/photo.d.ts +15 -0
  8. package/dist/core/packages/shared/src/pointer.d.ts +14 -0
  9. package/dist/core/packages/shared/src/react/index.d.ts +30 -0
  10. package/dist/core/packages/shared/src/reduced-motion.d.ts +4 -0
  11. package/dist/core/packages/shared/src/size.d.ts +8 -0
  12. package/dist/{packages/shared/src/index.d.ts → core/packages/shared/src/visibility.d.ts} +0 -1
  13. package/dist/core/packages/springMass/src/core.d.ts +1 -0
  14. package/dist/core/packages/springMass/src/element.d.ts +1 -0
  15. package/dist/core/packages/springMass/src/react.d.ts +3 -0
  16. package/dist/core/packages/springMass/src/vue.d.ts +2 -0
  17. package/dist/core/src/components/springMass/core/engine.d.ts +2 -0
  18. package/dist/core/src/components/springMass/core/index.d.ts +2 -0
  19. package/dist/{src/components/springMass/index.d.ts → core/src/components/springMass/core/types.d.ts} +8 -4
  20. package/dist/core/src/components/springMass/element/index.d.ts +9 -0
  21. package/dist/core/src/components/springMass/index.d.ts +3 -0
  22. package/dist/core/src/components/springMass/react/index.d.ts +4 -0
  23. package/dist/{src → core/src}/vite-env.d.ts +6 -0
  24. package/dist/element/element.css +1 -0
  25. package/dist/element/index.d.ts +1 -0
  26. package/dist/element/index.js +186 -0
  27. package/dist/element/packages/shared/src/canvas-box.d.ts +18 -0
  28. package/dist/element/packages/shared/src/host-layout.d.ts +22 -0
  29. package/dist/element/packages/shared/src/index.d.ts +11 -0
  30. package/dist/element/packages/shared/src/math.d.ts +2 -0
  31. package/dist/element/packages/shared/src/photo.d.ts +15 -0
  32. package/dist/element/packages/shared/src/pointer.d.ts +14 -0
  33. package/dist/element/packages/shared/src/react/index.d.ts +30 -0
  34. package/dist/element/packages/shared/src/reduced-motion.d.ts +4 -0
  35. package/dist/element/packages/shared/src/size.d.ts +8 -0
  36. package/dist/element/packages/shared/src/visibility.d.ts +2 -0
  37. package/dist/element/packages/springMass/src/core.d.ts +1 -0
  38. package/dist/element/packages/springMass/src/element.d.ts +1 -0
  39. package/dist/element/packages/springMass/src/index.d.ts +3 -0
  40. package/dist/element/packages/springMass/src/react.d.ts +3 -0
  41. package/dist/element/packages/springMass/src/vue.d.ts +2 -0
  42. package/dist/element/src/components/springMass/core/engine.d.ts +2 -0
  43. package/dist/element/src/components/springMass/core/index.d.ts +2 -0
  44. package/dist/element/src/components/springMass/core/types.d.ts +21 -0
  45. package/dist/element/src/components/springMass/element/index.d.ts +9 -0
  46. package/dist/element/src/components/springMass/index.d.ts +3 -0
  47. package/dist/element/src/components/springMass/react/index.d.ts +4 -0
  48. package/dist/element/src/vite-env.d.ts +45 -0
  49. package/dist/react/index.cjs +1 -0
  50. package/dist/react/index.d.ts +3 -0
  51. package/dist/react/index.js +177 -0
  52. package/dist/react/packages/shared/src/canvas-box.d.ts +18 -0
  53. package/dist/react/packages/shared/src/host-layout.d.ts +22 -0
  54. package/dist/react/packages/shared/src/index.d.ts +11 -0
  55. package/dist/react/packages/shared/src/math.d.ts +2 -0
  56. package/dist/react/packages/shared/src/photo.d.ts +15 -0
  57. package/dist/react/packages/shared/src/pointer.d.ts +14 -0
  58. package/dist/react/packages/shared/src/react/index.d.ts +30 -0
  59. package/dist/react/packages/shared/src/reduced-motion.d.ts +4 -0
  60. package/dist/react/packages/shared/src/size.d.ts +8 -0
  61. package/dist/react/packages/shared/src/visibility.d.ts +2 -0
  62. package/dist/react/packages/springMass/src/core.d.ts +1 -0
  63. package/dist/react/packages/springMass/src/element.d.ts +1 -0
  64. package/dist/react/packages/springMass/src/index.d.ts +3 -0
  65. package/dist/react/packages/springMass/src/react.d.ts +3 -0
  66. package/dist/react/packages/springMass/src/vue.d.ts +2 -0
  67. package/dist/react/react.css +1 -0
  68. package/dist/react/src/components/springMass/core/engine.d.ts +2 -0
  69. package/dist/react/src/components/springMass/core/index.d.ts +2 -0
  70. package/dist/react/src/components/springMass/core/types.d.ts +21 -0
  71. package/dist/react/src/components/springMass/element/index.d.ts +9 -0
  72. package/dist/react/src/components/springMass/index.d.ts +3 -0
  73. package/dist/react/src/components/springMass/react/index.d.ts +4 -0
  74. package/dist/react/src/vite-env.d.ts +45 -0
  75. package/dist/vue/index.d.ts +2 -0
  76. package/dist/vue/index.js +182 -0
  77. package/dist/vue/packages/shared/src/canvas-box.d.ts +18 -0
  78. package/dist/vue/packages/shared/src/host-layout.d.ts +22 -0
  79. package/dist/vue/packages/shared/src/index.d.ts +11 -0
  80. package/dist/vue/packages/shared/src/math.d.ts +2 -0
  81. package/dist/vue/packages/shared/src/photo.d.ts +15 -0
  82. package/dist/vue/packages/shared/src/pointer.d.ts +14 -0
  83. package/dist/vue/packages/shared/src/react/index.d.ts +30 -0
  84. package/dist/vue/packages/shared/src/reduced-motion.d.ts +4 -0
  85. package/dist/vue/packages/shared/src/size.d.ts +8 -0
  86. package/dist/vue/packages/shared/src/visibility.d.ts +2 -0
  87. package/dist/vue/packages/springMass/src/core.d.ts +1 -0
  88. package/dist/vue/packages/springMass/src/element.d.ts +1 -0
  89. package/dist/vue/packages/springMass/src/index.d.ts +3 -0
  90. package/dist/vue/packages/springMass/src/react.d.ts +3 -0
  91. package/dist/vue/packages/springMass/src/vue.d.ts +2 -0
  92. package/dist/vue/src/components/springMass/core/engine.d.ts +2 -0
  93. package/dist/vue/src/components/springMass/core/index.d.ts +2 -0
  94. package/dist/vue/src/components/springMass/core/types.d.ts +21 -0
  95. package/dist/vue/src/components/springMass/element/index.d.ts +9 -0
  96. package/dist/vue/src/components/springMass/index.d.ts +3 -0
  97. package/dist/vue/src/components/springMass/react/index.d.ts +4 -0
  98. package/dist/vue/src/vite-env.d.ts +45 -0
  99. package/dist/vue/vue.css +1 -0
  100. package/package.json +43 -11
  101. package/dist/index.cjs +0 -1
  102. package/dist/index.css +0 -1
  103. package/dist/index.d.ts +0 -3
  104. package/dist/index.js +0 -172
  105. /package/dist/{packages → core/packages}/springMass/src/index.d.ts +0 -0
@@ -0,0 +1,14 @@
1
+ export interface PointerPosition {
2
+ x: number;
3
+ y: number;
4
+ }
5
+ type PointLike = {
6
+ clientX: number;
7
+ clientY: number;
8
+ };
9
+ /** 相对元素左上角的指针坐标(兼容 mouse / touch / pointer) */
10
+ export declare const getRelativePointerPosition: (element: Element, event: PointLike | {
11
+ touches?: ArrayLike<PointLike>;
12
+ changedTouches?: ArrayLike<PointLike>;
13
+ }) => PointerPosition | null;
14
+ export {};
@@ -0,0 +1,30 @@
1
+ import { CSSProperties, RefObject } from 'react';
2
+ import { ElementSize } from '../size';
3
+ export type { CanvasBoxSize, CanvasBoxSizeInput } from '../canvas-box';
4
+ export { resolveCanvasBoxSize } from '../canvas-box';
5
+ export interface UseElementSizeOptions {
6
+ /** 为 false 时不观察 */
7
+ enabled?: boolean;
8
+ }
9
+ /** 观察元素尺寸(clientWidth / clientHeight) */
10
+ export declare const useElementSize: <T extends Element>(ref: RefObject<T | null>, options?: UseElementSizeOptions) => ElementSize;
11
+ export interface UseCanvasBoxOptions {
12
+ /** 为 true 时铺满父容器(父级需有明确高度) */
13
+ fill?: boolean;
14
+ width?: number;
15
+ height?: number;
16
+ defaultWidth: number;
17
+ defaultHeight: number;
18
+ }
19
+ export interface UseCanvasBoxResult {
20
+ hostRef: RefObject<HTMLDivElement | null>;
21
+ width: number;
22
+ height: number;
23
+ /** 挂到宿主容器的样式(fill 时为 100%×100%) */
24
+ hostStyle: CSSProperties;
25
+ fill: boolean;
26
+ /** 是否处于 fill 模式且尚未量到有效尺寸 */
27
+ pending: boolean;
28
+ }
29
+ /** 画布/效果宿主尺寸:fill 时跟随父容器,否则用显式宽高或默认值 */
30
+ export declare const useCanvasBox: ({ fill, width: widthProp, height: heightProp, defaultWidth, defaultHeight, }: UseCanvasBoxOptions) => UseCanvasBoxResult;
@@ -0,0 +1,4 @@
1
+ /** 当前是否偏好减少动效 */
2
+ export declare const prefersReducedMotion: () => boolean;
3
+ /** 监听 prefers-reduced-motion 变化;返回取消订阅函数 */
4
+ export declare const bindPrefersReducedMotion: (onChange: (reduced: boolean) => void) => () => void;
@@ -0,0 +1,8 @@
1
+ export interface ElementSize {
2
+ width: number;
3
+ height: number;
4
+ }
5
+ /** 观察元素内容尺寸;返回取消订阅函数 */
6
+ export declare const observeElementSize: (element: Element, onChange: (size: ElementSize) => void, options?: {
7
+ box?: ResizeObserverBoxOptions;
8
+ }) => () => void;
@@ -0,0 +1,2 @@
1
+ /** 注册 visibilitychange,页面隐藏时暂停动画循环 */
2
+ export declare const bindVisibilityPause: (onChange: (paused: boolean) => void) => () => void;
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/springMass/core';
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/springMass/element';
@@ -0,0 +1,3 @@
1
+ export { default } from '../../../src/components/springMass';
2
+ export { default as SpringMass } from '../../../src/components/springMass';
3
+ export type * from '../../../src/components/springMass';
@@ -0,0 +1,3 @@
1
+ export { default } from '../../../src/components/springMass/react';
2
+ export { default as SpringMass } from '../../../src/components/springMass/react';
3
+ export type * from '../../../src/components/springMass/core/types';
@@ -0,0 +1,2 @@
1
+ export { default as SpringMass } from '../../../src/components/springMass/vue/SpringMass.vue';
2
+ export type * from '../../../src/components/springMass/core/types';
@@ -0,0 +1,2 @@
1
+ import { SpringMassController, SpringMassOptions } from './types';
2
+ export declare function createSpringMass(container: HTMLElement, initial?: SpringMassOptions): SpringMassController;
@@ -0,0 +1,2 @@
1
+ export { createSpringMass } from './engine';
2
+ export type { SpringMassController, SpringMassOptions, SpringMassProps } from './types';
@@ -0,0 +1,21 @@
1
+ export interface SpringMassOptions {
2
+ width?: number;
3
+ height?: number;
4
+ /** 横向质点数量 */
5
+ cols?: number;
6
+ /** 纵向质点数量 */
7
+ rows?: number;
8
+ /** 弹簧刚度 0~1 */
9
+ stiffness?: number;
10
+ /** 速度阻尼 0~1 */
11
+ damping?: number;
12
+ /** 主色 */
13
+ color?: string;
14
+ /** 操作提示 */
15
+ hint?: string;
16
+ }
17
+ export interface SpringMassController {
18
+ update(options: Partial<SpringMassOptions>): void;
19
+ destroy(): void;
20
+ }
21
+ export type SpringMassProps = SpringMassOptions;
@@ -0,0 +1,9 @@
1
+ declare const TAG = "cos-spring-mass";
2
+ declare class CosSpringMassElement extends HTMLElement {
3
+ private ctrl;
4
+ static get observedAttributes(): string[];
5
+ connectedCallback(): void;
6
+ disconnectedCallback(): void;
7
+ attributeChangedCallback(): void;
8
+ }
9
+ export { CosSpringMassElement, TAG };
@@ -0,0 +1,3 @@
1
+ export { default } from './react';
2
+ export { default as SpringMass } from './react';
3
+ export type * from './core/types';
@@ -0,0 +1,4 @@
1
+ import { SpringMassOptions } from '../core';
2
+ export type { SpringMassOptions } from '../core/types';
3
+ declare const SpringMass: import('react').ForwardRefExoticComponent<SpringMassOptions & import('react').RefAttributes<unknown>>;
4
+ export default SpringMass;
@@ -0,0 +1,45 @@
1
+ /// <reference types="vite/client" />
2
+
3
+ declare module '*.vue' {
4
+ import type { DefineComponent } from 'vue';
5
+ const component: DefineComponent<object, object, unknown>;
6
+ export default component;
7
+ }
8
+
9
+ declare module '*.module.less' {
10
+ const classes: { readonly [key: string]: string };
11
+ export default classes;
12
+ }
13
+
14
+ declare module '*.less' {
15
+ const classes: { readonly [key: string]: string };
16
+ export default classes;
17
+ }
18
+
19
+ declare module '*.png' {
20
+ const src: string;
21
+ export default src;
22
+ }
23
+
24
+ declare module '*.jpg' {
25
+ const src: string;
26
+ export default src;
27
+ }
28
+
29
+ declare module '*.mp4' {
30
+ const src: string;
31
+ export default src;
32
+ }
33
+
34
+ declare module '*.mp3' {
35
+ const src: string;
36
+ export default src;
37
+ }
38
+
39
+ declare module '*.svg' {
40
+ import type { FC, SVGProps } from 'react';
41
+
42
+ export const ReactComponent: FC<SVGProps<SVGSVGElement>>;
43
+ const src: string;
44
+ export default src;
45
+ }
@@ -0,0 +1 @@
1
+ Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});require('./react.css');let e=require("react"),t=require("@cos-design/shared"),n=require("react/jsx-runtime");var r=`cos-spring-mass`,i=(e,t,n,r)=>{let i=Math.max(3,Math.min(n,10)),a=Math.max(3,Math.min(r,8)),o=e*.16,s=t*.18,c=(e-o*2)/(i-1),l=(t-s*2)/(a-1),u=[];for(let e=0;e<a;e++)for(let t=0;t<i;t++){let n=e===0&&(t===0||t===i-1)||e===a-1&&(t===0||t===i-1);u.push({x:o+t*c,y:s+e*l,vx:0,vy:0,pinned:n})}let d=[],f=(e,t)=>t*i+e;for(let e=0;e<a;e++)for(let t=0;t<i;t++)if(t<i-1&&d.push({a:f(t,e),b:f(t+1,e),rest:c}),e<a-1&&d.push({a:f(t,e),b:f(t,e+1),rest:l}),t<i-1&&e<a-1){let n=Math.hypot(c,l);d.push({a:f(t,e),b:f(t+1,e+1),rest:n}),d.push({a:f(t+1,e),b:f(t,e+1),rest:n})}return{nodes:u,springs:d}};function a(e,n={}){let a={width:560,height:400,cols:6,rows:5,stiffness:.22,damping:.9,color:`#a78bfa`,hint:`拖拽网格质点,观察弹簧回弹`,...n},o=!1,s=0,c=null,l=i(a.width??560,a.height??400,a.cols??6,a.rows??5),u=null,d={x:0,y:0},f=document.createElement(`div`),p=document.createElement(`canvas`);p.className=`${r}__canvas`;let m=document.createElement(`div`);m.className=`${r}__hint`,f.append(p,m),e.appendChild(f);let h=()=>{l=i(a.width??560,a.height??400,a.cols??6,a.rows??5),u=null},g=(e,t)=>{let n=-1,r=20;return l.nodes.forEach((i,a)=>{if(i.pinned)return;let o=Math.hypot(i.x-e,i.y-t);o<r&&(r=o,n=a)}),n},_=(e,t)=>{let n=p.getBoundingClientRect(),r=e-n.left,i=t-n.top;d.x=r,d.y=i;let a=g(r,i);if(a<0)return;let o=l.nodes[a];u={index:a,ox:o.x-r,oy:o.y-i}},v=(e,t)=>{let n=p.getBoundingClientRect();d.x=e-n.left,d.y=t-n.top},y=()=>{u=null},b=e=>_(e.clientX,e.clientY),x=e=>v(e.clientX,e.clientY),S=e=>{let t=e.touches[0];t&&_(t.clientX,t.clientY)},C=e=>{let t=e.touches[0];t&&v(t.clientX,t.clientY)};p.addEventListener(`mousedown`,b),p.addEventListener(`mousemove`,x),p.addEventListener(`mouseup`,y),p.addEventListener(`mouseleave`,y),p.addEventListener(`touchstart`,S,{passive:!0}),p.addEventListener(`touchmove`,C,{passive:!0}),p.addEventListener(`touchend`,y);let w=()=>{s&&cancelAnimationFrame(s),s=0,c?.(),c=null},T=()=>{if(w(),o)return;let e=a.width??560,n=a.height??400,i=a.color??`#a78bfa`,h=a.damping??.9,g=Math.max(.04,Math.min(a.stiffness??.22,.8));f.className=r,f.style.width=`${e}px`,f.style.height=`${n}px`,p.style.width=`${e}px`,p.style.height=`${n}px`,m.textContent=a.hint??`拖拽网格质点,观察弹簧回弹`;let _=window.devicePixelRatio||1;p.width=e*_,p.height=n*_;let v=p.getContext(`2d`);if(!v)return;v.setTransform(_,0,0,_,0,0);let y=typeof document<`u`?document.hidden:!1;c=(0,t.bindVisibilityPause)(e=>{y=e});let b=()=>{let{nodes:t,springs:r}=l;if(u){let e=t[u.index];e.x=d.x+u.ox,e.y=d.y+u.oy,e.vx=0,e.vy=0}for(let e of r){let n=t[e.a],r=t[e.b],i=r.x-n.x,a=r.y-n.y,o=Math.hypot(i,a)||.001,s=(o-e.rest)*g,c=i/o*s,l=a/o*s,d=u?.index===e.a,f=u?.index===e.b;!n.pinned&&!d&&(n.vx+=c,n.vy+=l),!r.pinned&&!f&&(r.vx-=c,r.vy-=l)}for(let r=0;r<t.length;r++){let i=t[r];if(i.pinned||u?.index===r){i.vx=0,i.vy=0;continue}i.vx*=h,i.vy*=h,i.x+=i.vx,i.y+=i.vy,i.x<10?(i.x=10,i.vx*=-.4):i.x>e-10&&(i.x=e-10,i.vx*=-.4),i.y<10?(i.y=10,i.vy*=-.4):i.y>n-10&&(i.y=n-10,i.vy*=-.4)}},x=()=>{let{nodes:t,springs:r}=l;v.fillStyle=`#0f172a`,v.fillRect(0,0,e,n);for(let a of r){let r=t[a.a],o=t[a.b],s=Math.hypot(o.x-r.x,o.y-r.y)||1,c=Math.min(1,Math.abs(s-a.rest)/a.rest);v.beginPath(),v.moveTo(r.x,r.y),v.lineTo(o.x,o.y),v.strokeStyle=i,v.globalAlpha=.22+c*.55,v.lineWidth=a.rest>Math.max(e,n)*.2?1:1.6,v.stroke(),v.globalAlpha=1}t.forEach((e,t)=>{v.beginPath(),v.arc(e.x,e.y,e.pinned?6:8,0,Math.PI*2),v.fillStyle=e.pinned?`#64748b`:i,v.fill(),v.strokeStyle=`rgb(255 255 255 / 28%)`,v.lineWidth=1,v.stroke(),u?.index===t&&(v.beginPath(),v.arc(e.x,e.y,13,0,Math.PI*2),v.strokeStyle=i,v.globalAlpha=.45,v.lineWidth=2,v.stroke(),v.globalAlpha=1)})},S=()=>{s=requestAnimationFrame(S),!(y||o)&&(b(),x())};s=requestAnimationFrame(S)};return h(),T(),{update(e){let t=a.width,n=a.height,r=a.cols,i=a.rows;a={...a,...e},(a.width!==t||a.height!==n||a.cols!==r||a.rows!==i)&&h(),T()},destroy(){o||(o=!0,w(),p.removeEventListener(`mousedown`,b),p.removeEventListener(`mousemove`,x),p.removeEventListener(`mouseup`,y),p.removeEventListener(`mouseleave`,y),p.removeEventListener(`touchstart`,S),p.removeEventListener(`touchmove`,C),p.removeEventListener(`touchend`,y),f.remove())}}}var o=(0,e.forwardRef)((r,i)=>{let o=(0,e.useRef)(null),s=(0,e.useRef)(null),c=(0,e.useRef)(r);c.current=r;let l=(0,e.useMemo)(()=>(0,t.optionsFingerprint)(r),[r]);return(0,e.useImperativeHandle)(i,()=>({})),(0,e.useEffect)(()=>{let e=o.current;if(!e)return;let t=a(e,c.current);return s.current=t,()=>{t.destroy(),s.current=null}},[]),(0,e.useEffect)(()=>{s.current?.update(c.current)},[l]),(0,n.jsx)(`div`,{ref:o,className:`cos-springMass-host`})});o.displayName=`SpringMass`,exports.SpringMass=o,exports.default=o;
@@ -0,0 +1,3 @@
1
+ export { default } from './src/components/springMass/react';
2
+ export { default as SpringMass } from './src/components/springMass/react';
3
+ export type * from './src/components/springMass/core/types';
@@ -0,0 +1,177 @@
1
+ import { forwardRef as e, useEffect as t, useImperativeHandle as n, useMemo as r, useRef as i } from "react";
2
+ import { bindVisibilityPause as a, optionsFingerprint as o } from "@cos-design/shared";
3
+ import { jsx as s } from "react/jsx-runtime";
4
+ import './react.css';//#region src/components/springMass/core/engine.ts
5
+ var c = "cos-spring-mass", l = (e, t, n, r) => {
6
+ let i = Math.max(3, Math.min(n, 10)), a = Math.max(3, Math.min(r, 8)), o = e * .16, s = t * .18, c = (e - o * 2) / (i - 1), l = (t - s * 2) / (a - 1), u = [];
7
+ for (let e = 0; e < a; e++) for (let t = 0; t < i; t++) {
8
+ let n = e === 0 && (t === 0 || t === i - 1) || e === a - 1 && (t === 0 || t === i - 1);
9
+ u.push({
10
+ x: o + t * c,
11
+ y: s + e * l,
12
+ vx: 0,
13
+ vy: 0,
14
+ pinned: n
15
+ });
16
+ }
17
+ let d = [], f = (e, t) => t * i + e;
18
+ for (let e = 0; e < a; e++) for (let t = 0; t < i; t++) if (t < i - 1 && d.push({
19
+ a: f(t, e),
20
+ b: f(t + 1, e),
21
+ rest: c
22
+ }), e < a - 1 && d.push({
23
+ a: f(t, e),
24
+ b: f(t, e + 1),
25
+ rest: l
26
+ }), t < i - 1 && e < a - 1) {
27
+ let n = Math.hypot(c, l);
28
+ d.push({
29
+ a: f(t, e),
30
+ b: f(t + 1, e + 1),
31
+ rest: n
32
+ }), d.push({
33
+ a: f(t + 1, e),
34
+ b: f(t, e + 1),
35
+ rest: n
36
+ });
37
+ }
38
+ return {
39
+ nodes: u,
40
+ springs: d
41
+ };
42
+ };
43
+ function u(e, t = {}) {
44
+ let n = {
45
+ width: 560,
46
+ height: 400,
47
+ cols: 6,
48
+ rows: 5,
49
+ stiffness: .22,
50
+ damping: .9,
51
+ color: "#a78bfa",
52
+ hint: "拖拽网格质点,观察弹簧回弹",
53
+ ...t
54
+ }, r = !1, i = 0, o = null, s = l(n.width ?? 560, n.height ?? 400, n.cols ?? 6, n.rows ?? 5), u = null, d = {
55
+ x: 0,
56
+ y: 0
57
+ }, f = document.createElement("div"), p = document.createElement("canvas");
58
+ p.className = `${c}__canvas`;
59
+ let m = document.createElement("div");
60
+ m.className = `${c}__hint`, f.append(p, m), e.appendChild(f);
61
+ let h = () => {
62
+ s = l(n.width ?? 560, n.height ?? 400, n.cols ?? 6, n.rows ?? 5), u = null;
63
+ }, g = (e, t) => {
64
+ let n = -1, r = 20;
65
+ return s.nodes.forEach((i, a) => {
66
+ if (i.pinned) return;
67
+ let o = Math.hypot(i.x - e, i.y - t);
68
+ o < r && (r = o, n = a);
69
+ }), n;
70
+ }, _ = (e, t) => {
71
+ let n = p.getBoundingClientRect(), r = e - n.left, i = t - n.top;
72
+ d.x = r, d.y = i;
73
+ let a = g(r, i);
74
+ if (a < 0) return;
75
+ let o = s.nodes[a];
76
+ u = {
77
+ index: a,
78
+ ox: o.x - r,
79
+ oy: o.y - i
80
+ };
81
+ }, v = (e, t) => {
82
+ let n = p.getBoundingClientRect();
83
+ d.x = e - n.left, d.y = t - n.top;
84
+ }, y = () => {
85
+ u = null;
86
+ }, b = (e) => _(e.clientX, e.clientY), x = (e) => v(e.clientX, e.clientY), S = (e) => {
87
+ let t = e.touches[0];
88
+ t && _(t.clientX, t.clientY);
89
+ }, C = (e) => {
90
+ let t = e.touches[0];
91
+ t && v(t.clientX, t.clientY);
92
+ };
93
+ p.addEventListener("mousedown", b), p.addEventListener("mousemove", x), p.addEventListener("mouseup", y), p.addEventListener("mouseleave", y), p.addEventListener("touchstart", S, { passive: !0 }), p.addEventListener("touchmove", C, { passive: !0 }), p.addEventListener("touchend", y);
94
+ let w = () => {
95
+ i && cancelAnimationFrame(i), i = 0, o?.(), o = null;
96
+ }, T = () => {
97
+ if (w(), r) return;
98
+ let e = n.width ?? 560, t = n.height ?? 400, l = n.color ?? "#a78bfa", h = n.damping ?? .9, g = Math.max(.04, Math.min(n.stiffness ?? .22, .8));
99
+ f.className = c, f.style.width = `${e}px`, f.style.height = `${t}px`, p.style.width = `${e}px`, p.style.height = `${t}px`, m.textContent = n.hint ?? "拖拽网格质点,观察弹簧回弹";
100
+ let _ = window.devicePixelRatio || 1;
101
+ p.width = e * _, p.height = t * _;
102
+ let v = p.getContext("2d");
103
+ if (!v) return;
104
+ v.setTransform(_, 0, 0, _, 0, 0);
105
+ let y = typeof document < "u" ? document.hidden : !1;
106
+ o = a((e) => {
107
+ y = e;
108
+ });
109
+ let b = () => {
110
+ let { nodes: n, springs: r } = s;
111
+ if (u) {
112
+ let e = n[u.index];
113
+ e.x = d.x + u.ox, e.y = d.y + u.oy, e.vx = 0, e.vy = 0;
114
+ }
115
+ for (let e of r) {
116
+ let t = n[e.a], r = n[e.b], i = r.x - t.x, a = r.y - t.y, o = Math.hypot(i, a) || .001, s = (o - e.rest) * g, c = i / o * s, l = a / o * s, d = u?.index === e.a, f = u?.index === e.b;
117
+ !t.pinned && !d && (t.vx += c, t.vy += l), !r.pinned && !f && (r.vx -= c, r.vy -= l);
118
+ }
119
+ for (let r = 0; r < n.length; r++) {
120
+ let i = n[r];
121
+ if (i.pinned || u?.index === r) {
122
+ i.vx = 0, i.vy = 0;
123
+ continue;
124
+ }
125
+ i.vx *= h, i.vy *= h, i.x += i.vx, i.y += i.vy, i.x < 10 ? (i.x = 10, i.vx *= -.4) : i.x > e - 10 && (i.x = e - 10, i.vx *= -.4), i.y < 10 ? (i.y = 10, i.vy *= -.4) : i.y > t - 10 && (i.y = t - 10, i.vy *= -.4);
126
+ }
127
+ }, x = () => {
128
+ let { nodes: n, springs: r } = s;
129
+ v.fillStyle = "#0f172a", v.fillRect(0, 0, e, t);
130
+ for (let i of r) {
131
+ let r = n[i.a], a = n[i.b], o = Math.hypot(a.x - r.x, a.y - r.y) || 1, s = Math.min(1, Math.abs(o - i.rest) / i.rest);
132
+ v.beginPath(), v.moveTo(r.x, r.y), v.lineTo(a.x, a.y), v.strokeStyle = l, v.globalAlpha = .22 + s * .55, v.lineWidth = i.rest > Math.max(e, t) * .2 ? 1 : 1.6, v.stroke(), v.globalAlpha = 1;
133
+ }
134
+ n.forEach((e, t) => {
135
+ v.beginPath(), v.arc(e.x, e.y, e.pinned ? 6 : 8, 0, Math.PI * 2), v.fillStyle = e.pinned ? "#64748b" : l, v.fill(), v.strokeStyle = "rgb(255 255 255 / 28%)", v.lineWidth = 1, v.stroke(), u?.index === t && (v.beginPath(), v.arc(e.x, e.y, 13, 0, Math.PI * 2), v.strokeStyle = l, v.globalAlpha = .45, v.lineWidth = 2, v.stroke(), v.globalAlpha = 1);
136
+ });
137
+ }, S = () => {
138
+ i = requestAnimationFrame(S), !(y || r) && (b(), x());
139
+ };
140
+ i = requestAnimationFrame(S);
141
+ };
142
+ return h(), T(), {
143
+ update(e) {
144
+ let t = n.width, r = n.height, i = n.cols, a = n.rows;
145
+ n = {
146
+ ...n,
147
+ ...e
148
+ }, (n.width !== t || n.height !== r || n.cols !== i || n.rows !== a) && h(), T();
149
+ },
150
+ destroy() {
151
+ r || (r = !0, w(), p.removeEventListener("mousedown", b), p.removeEventListener("mousemove", x), p.removeEventListener("mouseup", y), p.removeEventListener("mouseleave", y), p.removeEventListener("touchstart", S), p.removeEventListener("touchmove", C), p.removeEventListener("touchend", y), f.remove());
152
+ }
153
+ };
154
+ }
155
+ //#endregion
156
+ //#region src/components/springMass/react/index.tsx
157
+ var d = e((e, a) => {
158
+ let c = i(null), l = i(null), d = i(e);
159
+ d.current = e;
160
+ let f = r(() => o(e), [e]);
161
+ return n(a, () => ({})), t(() => {
162
+ let e = c.current;
163
+ if (!e) return;
164
+ let t = u(e, d.current);
165
+ return l.current = t, () => {
166
+ t.destroy(), l.current = null;
167
+ };
168
+ }, []), t(() => {
169
+ l.current?.update(d.current);
170
+ }, [f]), /* @__PURE__ */ s("div", {
171
+ ref: c,
172
+ className: "cos-springMass-host"
173
+ });
174
+ });
175
+ d.displayName = "SpringMass";
176
+ //#endregion
177
+ export { d as SpringMass, d as default };
@@ -0,0 +1,18 @@
1
+ import { ElementSize } from './size';
2
+ export interface CanvasBoxSizeInput {
3
+ /** 为 true 时跟随父容器尺寸(需父级有明确高度) */
4
+ fill?: boolean;
5
+ width?: number;
6
+ height?: number;
7
+ defaultWidth: number;
8
+ defaultHeight: number;
9
+ measured: ElementSize;
10
+ }
11
+ export interface CanvasBoxSize {
12
+ width: number;
13
+ height: number;
14
+ /** 是否处于 fill 模式且尚未量到有效尺寸 */
15
+ pending: boolean;
16
+ }
17
+ /** 根据 fill / 显式宽高 / 测量结果解析画布逻辑尺寸 */
18
+ export declare const resolveCanvasBoxSize: ({ fill, width, height, defaultWidth, defaultHeight, measured, }: CanvasBoxSizeInput) => CanvasBoxSize;
@@ -0,0 +1,22 @@
1
+ /** Apply fill / explicit size to the adapter host and make the engine root fill it. */
2
+ export declare function applyCanvasHostBox(container: HTMLElement, root: HTMLElement, opts: {
3
+ fill: boolean;
4
+ width: number;
5
+ height: number;
6
+ }): void;
7
+ /**
8
+ * Size the adapter host (React/Vue div or custom element) so percentage widths
9
+ * don't collapse when the host is a shrink-wrapped flex child. Root fills the host
10
+ * unless `rootFillsHost` is false (e.g. PhotoAlbum sizes itself via CSS variables).
11
+ */
12
+ export declare function applyBlockHostBox(container: HTMLElement, root: HTMLElement, size: {
13
+ width?: number | string;
14
+ height?: number | string;
15
+ rootFillsHost?: boolean;
16
+ }): void;
17
+ /** Toggle empty-state nodes; author `display:` rules must not override `[hidden]`. */
18
+ export declare function setHidden(el: HTMLElement, hidden: boolean): void;
19
+ /** Stable JSON key for options, ignoring functions (callbacks). */
20
+ export declare function optionsFingerprint(value: unknown): string;
21
+ /** True when non-function fields differ (shallow). */
22
+ export declare function optionsVisualChanged(prev: Record<string, unknown>, next: Record<string, unknown>): boolean;
@@ -0,0 +1,11 @@
1
+ export { clamp, lerp } from './math';
2
+ export { bindVisibilityPause } from './visibility';
3
+ export { prefersReducedMotion, bindPrefersReducedMotion } from './reduced-motion';
4
+ export { observeElementSize } from './size';
5
+ export type { ElementSize } from './size';
6
+ export { getRelativePointerPosition } from './pointer';
7
+ export type { PointerPosition } from './pointer';
8
+ export type { PhotoItem, PhotoIndexChangeHandler, PhotoFaceChangeHandler } from './photo';
9
+ export { resolveCanvasBoxSize } from './canvas-box';
10
+ export type { CanvasBoxSizeInput, CanvasBoxSize } from './canvas-box';
11
+ export { applyCanvasHostBox, applyBlockHostBox, setHidden, optionsFingerprint, optionsVisualChanged, } from './host-layout';
@@ -0,0 +1,2 @@
1
+ export declare const clamp: (value: number, min: number, max: number) => number;
2
+ export declare const lerp: (a: number, b: number, t: number) => number;
@@ -0,0 +1,15 @@
1
+ /** 图片预览组件通用照片项 */
2
+ export interface PhotoItem {
3
+ /** 图片地址 */
4
+ src: string;
5
+ /** 图片替代文本 */
6
+ alt?: string;
7
+ /** 照片标题 */
8
+ title?: string;
9
+ /** 照片说明 */
10
+ description?: string;
11
+ }
12
+ /** 线性浏览:当前索引变化(相册 / 胶卷 / 晾绳等) */
13
+ export type PhotoIndexChangeHandler<T = PhotoItem> = (index: number, photo: T) => void;
14
+ /** 环形浏览:正对镜头的面变化(走马灯 / 旋转木马等) */
15
+ export type PhotoFaceChangeHandler<T = PhotoItem> = (index: number, photo?: T) => void;
@@ -0,0 +1,14 @@
1
+ export interface PointerPosition {
2
+ x: number;
3
+ y: number;
4
+ }
5
+ type PointLike = {
6
+ clientX: number;
7
+ clientY: number;
8
+ };
9
+ /** 相对元素左上角的指针坐标(兼容 mouse / touch / pointer) */
10
+ export declare const getRelativePointerPosition: (element: Element, event: PointLike | {
11
+ touches?: ArrayLike<PointLike>;
12
+ changedTouches?: ArrayLike<PointLike>;
13
+ }) => PointerPosition | null;
14
+ export {};
@@ -0,0 +1,30 @@
1
+ import { CSSProperties, RefObject } from 'react';
2
+ import { ElementSize } from '../size';
3
+ export type { CanvasBoxSize, CanvasBoxSizeInput } from '../canvas-box';
4
+ export { resolveCanvasBoxSize } from '../canvas-box';
5
+ export interface UseElementSizeOptions {
6
+ /** 为 false 时不观察 */
7
+ enabled?: boolean;
8
+ }
9
+ /** 观察元素尺寸(clientWidth / clientHeight) */
10
+ export declare const useElementSize: <T extends Element>(ref: RefObject<T | null>, options?: UseElementSizeOptions) => ElementSize;
11
+ export interface UseCanvasBoxOptions {
12
+ /** 为 true 时铺满父容器(父级需有明确高度) */
13
+ fill?: boolean;
14
+ width?: number;
15
+ height?: number;
16
+ defaultWidth: number;
17
+ defaultHeight: number;
18
+ }
19
+ export interface UseCanvasBoxResult {
20
+ hostRef: RefObject<HTMLDivElement | null>;
21
+ width: number;
22
+ height: number;
23
+ /** 挂到宿主容器的样式(fill 时为 100%×100%) */
24
+ hostStyle: CSSProperties;
25
+ fill: boolean;
26
+ /** 是否处于 fill 模式且尚未量到有效尺寸 */
27
+ pending: boolean;
28
+ }
29
+ /** 画布/效果宿主尺寸:fill 时跟随父容器,否则用显式宽高或默认值 */
30
+ export declare const useCanvasBox: ({ fill, width: widthProp, height: heightProp, defaultWidth, defaultHeight, }: UseCanvasBoxOptions) => UseCanvasBoxResult;
@@ -0,0 +1,4 @@
1
+ /** 当前是否偏好减少动效 */
2
+ export declare const prefersReducedMotion: () => boolean;
3
+ /** 监听 prefers-reduced-motion 变化;返回取消订阅函数 */
4
+ export declare const bindPrefersReducedMotion: (onChange: (reduced: boolean) => void) => () => void;
@@ -0,0 +1,8 @@
1
+ export interface ElementSize {
2
+ width: number;
3
+ height: number;
4
+ }
5
+ /** 观察元素内容尺寸;返回取消订阅函数 */
6
+ export declare const observeElementSize: (element: Element, onChange: (size: ElementSize) => void, options?: {
7
+ box?: ResizeObserverBoxOptions;
8
+ }) => () => void;
@@ -0,0 +1,2 @@
1
+ /** 注册 visibilitychange,页面隐藏时暂停动画循环 */
2
+ export declare const bindVisibilityPause: (onChange: (paused: boolean) => void) => () => void;
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/springMass/core';
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/springMass/element';
@@ -0,0 +1,3 @@
1
+ export { default } from '../../../src/components/springMass';
2
+ export { default as SpringMass } from '../../../src/components/springMass';
3
+ export type * from '../../../src/components/springMass';
@@ -0,0 +1,3 @@
1
+ export { default } from '../../../src/components/springMass/react';
2
+ export { default as SpringMass } from '../../../src/components/springMass/react';
3
+ export type * from '../../../src/components/springMass/core/types';
@@ -0,0 +1,2 @@
1
+ export { default as SpringMass } from '../../../src/components/springMass/vue/SpringMass.vue';
2
+ export type * from '../../../src/components/springMass/core/types';
@@ -0,0 +1 @@
1
+ .cos-spring-mass{background:linear-gradient(#0f172a,#020617);border:1px solid #94a3b824;border-radius:18px;position:relative;overflow:hidden;box-shadow:0 18px 42px #0206174d}.cos-spring-mass__canvas{cursor:grab;display:block}.cos-spring-mass__canvas:active{cursor:grabbing}.cos-spring-mass__hint{color:#e2e8f0d9;letter-spacing:.06em;-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px);background:#0f172a73;border:1px solid #ffffff14;border-radius:999px;padding:6px 10px;font-size:12px;position:absolute;bottom:12px;right:14px}
@@ -0,0 +1,2 @@
1
+ import { SpringMassController, SpringMassOptions } from './types';
2
+ export declare function createSpringMass(container: HTMLElement, initial?: SpringMassOptions): SpringMassController;
@@ -0,0 +1,2 @@
1
+ export { createSpringMass } from './engine';
2
+ export type { SpringMassController, SpringMassOptions, SpringMassProps } from './types';
@@ -0,0 +1,21 @@
1
+ export interface SpringMassOptions {
2
+ width?: number;
3
+ height?: number;
4
+ /** 横向质点数量 */
5
+ cols?: number;
6
+ /** 纵向质点数量 */
7
+ rows?: number;
8
+ /** 弹簧刚度 0~1 */
9
+ stiffness?: number;
10
+ /** 速度阻尼 0~1 */
11
+ damping?: number;
12
+ /** 主色 */
13
+ color?: string;
14
+ /** 操作提示 */
15
+ hint?: string;
16
+ }
17
+ export interface SpringMassController {
18
+ update(options: Partial<SpringMassOptions>): void;
19
+ destroy(): void;
20
+ }
21
+ export type SpringMassProps = SpringMassOptions;
@@ -0,0 +1,9 @@
1
+ declare const TAG = "cos-spring-mass";
2
+ declare class CosSpringMassElement extends HTMLElement {
3
+ private ctrl;
4
+ static get observedAttributes(): string[];
5
+ connectedCallback(): void;
6
+ disconnectedCallback(): void;
7
+ attributeChangedCallback(): void;
8
+ }
9
+ export { CosSpringMassElement, TAG };
@@ -0,0 +1,3 @@
1
+ export { default } from './react';
2
+ export { default as SpringMass } from './react';
3
+ export type * from './core/types';
@@ -0,0 +1,4 @@
1
+ import { SpringMassOptions } from '../core';
2
+ export type { SpringMassOptions } from '../core/types';
3
+ declare const SpringMass: import('react').ForwardRefExoticComponent<SpringMassOptions & import('react').RefAttributes<unknown>>;
4
+ export default SpringMass;