@longzai-intelligence-liquid-glass/core 0.0.1

package/README.md

@@ -0,0 +1,12 @@
+# @longzai-intelligence-liquid-glass/core
+
+Liquid Glass 框架无关核心：形状 SDF、光学剖面、参数模型与渲染器抽象接口。零平台依赖。
+
+## 用法
+
+```bash
+bun run --cwd packages/core lint      # 代码检查
+bun run --cwd packages/core typecheck # 类型检查（tsgo）
+bun run --cwd packages/core test      # 单元测试
+bun run --cwd packages/core build     # 构建（lzi-builder → dist）
+```

package/dist/index.d.ts

@@ -0,0 +1,724 @@
+//#region src/shapes/sdf.utils.d.ts
+/**
+ * 形状符号距离函数（SDF）
+ *
+ * 全部渲染后端共享的几何底座：以形状中心为原点、屏幕坐标系（+y 向下）求值，
+ * 内部为负、边界为零、外部为正。圆角矩形支持 squircle 角平滑（superellipse 推广，
+ * 源自 Kyant0/AndroidLiquidGlass 与 AndrewPrifer/liquid-dom 的 squircle 处理思路）。
+ */
+/**
+ * 形状类别
+ *
+ * - rounded-rect：圆角矩形（含 squircle 角平滑）
+ * - circle：圆形
+ * - pill：胶囊形（stadium）
+ */
+type GlassShapeKind = 'rounded-rect' | 'circle' | 'pill';
+/**
+ * 形状描述子
+ */
+type GlassShapeDescriptor = {
+  /**
+   * 形状类别
+   */
+  kind: GlassShapeKind;
+  /**
+   * 形状外接宽度（px）
+   */
+  width: number;
+  /**
+   * 形状外接高度（px）
+   */
+  height: number;
+  /**
+   * 圆角半径（px），circle / pill 时由尺寸推导
+   */
+  radius: number;
+  /**
+   * squircle 角平滑度 0..1（0 = 圆角，1 = 最大平滑）
+   */
+  smoothing: number;
+};
+/**
+ * 圆形 SDF
+ *
+ * @param px - 采样点 x（相对圆心）
+ * @param py - 采样点 y（相对圆心）
+ * @param radius - 半径（px）
+ * @returns 符号距离（px）
+ */
+declare function sdCircle(px: number, py: number, radius: number): number;
+/**
+ * 胶囊形（stadium）SDF：点到中轴线段的距离减去胶囊半径
+ *
+ * @param px - 采样点 x（相对形状中心）
+ * @param py - 采样点 y（相对形状中心）
+ * @param width - 外接宽度（px）
+ * @param height - 外接高度（px）
+ * @returns 符号距离（px）
+ */
+declare function sdPill(px: number, py: number, width: number, height: number): number;
+/**
+ * 圆角矩形 SDF（Inigo Quilez 精确公式，smoothing = 0 时）
+ *
+ * @param px - 采样点 x（相对形状中心）
+ * @param py - 采样点 y（相对形状中心）
+ * @param halfWidth - 半宽（px）
+ * @param halfHeight - 半高（px）
+ * @param radius - 圆角半径（px）
+ * @returns 符号距离（px）
+ */
+declare function sdRoundedRect(px: number, py: number, halfWidth: number, halfHeight: number, radius: number): number;
+/**
+ * squircle 角平滑的圆角矩形 SDF
+ *
+ * 以 superellipse 范数推广圆角：指数 n = 2 时退化为精确圆角矩形，
+ * smoothing 增大时角部逐渐"饱满"（Apple 风格连续曲率角的近似）。
+ *
+ * @param px - 采样点 x（相对形状中心）
+ * @param py - 采样点 y（相对形状中心）
+ * @param halfWidth - 半宽（px）
+ * @param halfHeight - 半高（px）
+ * @param radius - 圆角半径（px）
+ * @param smoothing - 角平滑度 0..1
+ * @returns 符号距离（px）
+ */
+declare function sdRoundedRectSmooth(px: number, py: number, halfWidth: number, halfHeight: number, radius: number, smoothing: number): number;
+/**
+ * 按形状描述子求 SDF
+ *
+ * @param px - 采样点 x（相对形状中心）
+ * @param py - 采样点 y（相对形状中心）
+ * @param descriptor - 形状描述子
+ * @returns 符号距离（px）
+ */
+declare function sdShape(px: number, py: number, descriptor: GlassShapeDescriptor): number;
+//#endregion
+//#region src/math/vec2.utils.d.ts
+/**
+ * 二维向量工具
+ *
+ * 玻璃几何与光学计算所需的零依赖向量运算（SDF 梯度、折射位移方向等）。
+ */
+/**
+ * 二维向量
+ */
+type Vec2 = {
+  /**
+   * x 分量（屏幕坐标系下指向右）
+   */
+  x: number;
+  /**
+   * y 分量（屏幕坐标系下指向下）
+   */
+  y: number;
+};
+/**
+ * 构造二维向量
+ *
+ * @param x - x 分量
+ * @param y - y 分量
+ * @returns 二维向量
+ */
+declare function vec2(x: number, y: number): Vec2;
+/**
+ * 向量加法
+ *
+ * @param a - 左操作数
+ * @param b - 右操作数
+ * @returns a + b
+ */
+declare function addVec2(a: Vec2, b: Vec2): Vec2;
+/**
+ * 向量减法
+ *
+ * @param a - 左操作数
+ * @param b - 右操作数
+ * @returns a - b
+ */
+declare function subVec2(a: Vec2, b: Vec2): Vec2;
+/**
+ * 向量数乘
+ *
+ * @param v - 向量
+ * @param s - 缩放系数
+ * @returns s * v
+ */
+declare function scaleVec2(v: Vec2, s: number): Vec2;
+/**
+ * 向量点积
+ *
+ * @param a - 左操作数
+ * @param b - 右操作数
+ * @returns a · b
+ */
+declare function dotVec2(a: Vec2, b: Vec2): number;
+/**
+ * 向量长度
+ *
+ * @param v - 向量
+ * @returns |v|
+ */
+declare function lengthVec2(v: Vec2): number;
+/**
+ * 向量归一化（零向量安全，返回零向量）
+ *
+ * @param v - 向量
+ * @returns 单位向量；|v| = 0 时返回 (0, 0)
+ */
+declare function normalizeVec2(v: Vec2): Vec2;
+//#endregion
+//#region src/shapes/gradient.utils.d.ts
+/**
+ * 标量场采样函数（如 SDF）
+ */
+type ScalarField = (x: number, y: number) => number;
+/**
+ * 标量场梯度（中心差分）
+ *
+ * @param field - 标量场
+ * @param px - 采样点 x
+ * @param py - 采样点 y
+ * @param epsilon - 差分步长（px）
+ * @returns 梯度向量（未归一化，指向函数增长方向）
+ */
+declare function fieldGradient(field: ScalarField, px: number, py: number, epsilon?: number): Vec2;
+/**
+ * SDF 外法线（梯度归一化，边界内侧同样指向外侧）
+ *
+ * @param field - SDF 标量场
+ * @param px - 采样点 x
+ * @param py - 采样点 y
+ * @param epsilon - 差分步长（px）
+ * @returns 单位外法线；梯度为零时返回 (0, 0)
+ */
+declare function sdfOutwardNormal(field: ScalarField, px: number, py: number, epsilon?: number): Vec2;
+/**
+ * 玻璃高度场表面法线（二维投影）
+ *
+ * 高度场 h(x, y) 的表面法线在 xy 平面的投影为 -∇h，
+ * 归一化后即折射偏折方向（slope prepass 的位移方向来源）。
+ *
+ * @param heightField - 高度场
+ * @param px - 采样点 x
+ * @param py - 采样点 y
+ * @param epsilon - 差分步长（px）
+ * @returns 单位向量；梯度为零时返回 (0, 0)
+ */
+declare function heightFieldNormal(heightField: ScalarField, px: number, py: number, epsilon?: number): Vec2;
+//#endregion
+//#region src/optics/height-profile.utils.d.ts
+/**
+ * 边缘高度剖面
+ *
+ * 把"距边深度"映射为玻璃表面高度：中心平坦、边缘带隆起。
+ * circleMap 弧面映射源自 Kyant0/AndroidLiquidGlass；
+ * bevel 幂曲线源自 naughtyduk/liquidGL 的 pow(edge, N) bevel 项。
+ */
+/**
+ * circleMap：归一化深度 x ∈ [0,1] → 弧面高度 [0,1]
+ *
+ * 把直角深度映射为圆弧高度（1 端对应边缘），使折射带呈现真实的凸透镜弧面。
+ *
+ * @param x - 归一化深度（0 = 折射带内边界，1 = 形状边界）
+ * @returns 弧面高度 [0, 1]
+ */
+declare function circleMap(x: number): number;
+/**
+ * 边缘因子：SDF 值 → [0, 1]（1 = 形状边界，0 = 折射带内边界及更内侧）
+ *
+ * @param sdf - 符号距离（px，内部为负）
+ * @param band - 折射带宽度（px，从边界向内）
+ * @returns 边缘因子 [0, 1]
+ */
+declare function edgeFactor(sdf: number, band: number): number;
+/**
+ * 边缘高度剖面参数
+ */
+type HeightProfileParams = {
+  /**
+   * 基础折射带弧面强度 0..1
+   */
+  refraction: number;
+  /**
+   * 折射带宽度（px）
+   */
+  refractionHeight: number;
+  /**
+   * bevel（斜面）强度 0..1：在边界处叠加更陡的斜边
+   */
+  bevel: number;
+  /**
+   * bevel 幂（越大斜边越集中在最边缘）
+   */
+  bevelExponent: number;
+};
+/**
+ * 边缘高度剖面：SDF → 表面高度 [0, refraction + bevel]
+ *
+ * h = refraction · circleMap(f) + bevel · f^bevelExponent，
+ * f 为边缘因子；中心区（f = 0）平坦为零，保证只有边缘带发生折射。
+ *
+ * @param sdf - 符号距离（px）
+ * @param params - 剖面参数
+ * @returns 表面高度（无量纲，量级 ≤ refraction + bevel）
+ */
+declare function edgeHeightProfile(sdf: number, params: HeightProfileParams): number;
+//#endregion
+//#region src/optics/refraction.utils.d.ts
+/**
+ * 折射位移参数
+ */
+type RefractionParams = {
+  /**
+   * 整体位移缩放系数（像素级强度，默认 1 表示位移上限 ≈ refractionHeight · refraction）
+   */
+  displacementScale: number;
+} & HeightProfileParams;
+/**
+ * 折射位移向量
+ *
+ * @param sdf - 符号距离（px）
+ * @param outwardNormal - SDF 单位外法线
+ * @param params - 折射参数
+ * @returns 背景采样位移（px，指向形状内侧为负向外法线方向）
+ */
+declare function refractionDisplacement(sdf: number, outwardNormal: Vec2, params: RefractionParams): Vec2;
+/**
+ * 折射位移幅值（供调试与位移图编码范围评估）
+ *
+ * @param params - 折射参数
+ * @returns 理论最大位移幅值（px）
+ */
+declare function maxDisplacement(params: RefractionParams): number;
+//#endregion
+//#region src/optics/dispersion.utils.d.ts
+/**
+ * 三通道色散缩放系数
+ */
+type SpectralDispersionScales = {
+  /**
+   * 红通道位移系数（相对基准位移）
+   */
+  r: number;
+  /**
+   * 绿通道位移系数（基准 1）
+   */
+  g: number;
+  /**
+   * 蓝通道位移系数
+   */
+  b: number;
+};
+/**
+ * 七光谱采样权重（归一化）：R / O / Y / G / C / B / P
+ *
+ * 光谱两端的折射率偏差最大，边缘色散由两端权重贡献。
+ */
+declare const SPECTRAL_WEIGHTS: readonly number[];
+/**
+ * 三通道对称色散缩放（liquidGL 方案）
+ *
+ * R/B 沿折射方向对称缩放：dispersion = 0 时三通道一致（无色散），
+ * 增大时蓝端偏移更大（模拟真实玻璃的蓝光高折射率）。
+ *
+ * @param dispersion - 色散强度 0..1
+ * @returns 三通道位移系数
+ */
+declare function channelDispersionScales(dispersion: number): SpectralDispersionScales;
+/**
+ * 三通道位移结果
+ */
+type ChannelDisplacements = {
+  /**
+   * 红通道位移
+   */
+  r: Vec2;
+  /**
+   * 绿通道位移
+   */
+  g: Vec2;
+  /**
+   * 蓝通道位移
+   */
+  b: Vec2;
+};
+/**
+ * 三通道色散位移
+ *
+ * @param displacement - 基准折射位移（px）
+ * @param dispersion - 色散强度 0..1
+ * @returns R/G/B 三通道位移向量
+ */
+declare function channelDisplacements(displacement: Vec2, dispersion: number): ChannelDisplacements;
+/**
+ * 七光谱合成位移（Kyant0 方案）
+ *
+ * 对基准位移按光谱折射率偏差插值采样并加权平均，
+ * 位移随光谱位置单调变化，产生平滑的彩虹边缘。
+ *
+ * @param displacement - 基准折射位移（px）
+ * @param dispersion - 色散强度 0..1
+ * @returns 光谱加权平均位移（px）
+ */
+declare function spectralDisplacement(displacement: Vec2, dispersion: number): Vec2;
+//#endregion
+//#region src/optics/specular.utils.d.ts
+/**
+ * 高光参数
+ */
+type SpecularParams = {
+  /**
+   * 高光强度 0..1
+   */
+  specular: number;
+  /**
+   * 高光锐度（幂次，越大高光带越窄）
+   */
+  specularExponent: number;
+};
+/**
+ * rim 高光 falloff
+ *
+ * @param cosine - 法线与光方向夹角余弦
+ * @param exponent - 幂次
+ * @returns falloff 值 [0, 1]
+ */
+declare function rimFalloff(cosine: number, exponent: number): number;
+/**
+ * 单侧 rim 高光强度
+ *
+ * @param outwardNormal - SDF 单位外法线
+ * @param lightDirection - 光方向（单位向量，从表面指向光源）
+ * @param params - 高光参数
+ * @returns 高光强度 [0, specular]
+ */
+declare function rimSpecular(outwardNormal: Vec2, lightDirection: Vec2, params: SpecularParams): number;
+/**
+ * 双光斑 rim 高光（主光 + 镜像对侧光，liquidGL 双 specular 方案）
+ *
+ * @param outwardNormal - SDF 单位外法线
+ * @param lightDirection - 主光方向（单位向量）
+ * @param params - 高光参数
+ * @returns 两侧高光合成强度
+ */
+declare function dualRimSpecular(outwardNormal: Vec2, lightDirection: Vec2, params: SpecularParams): number;
+//#endregion
+//#region src/params/params.types.d.ts
+/**
+ * RGBA 颜色（各分量 0..1）
+ */
+type RGBA = {
+  /**
+   * 红通道 0..1
+   */
+  r: number;
+  /**
+   * 绿通道 0..1
+   */
+  g: number;
+  /**
+   * 蓝通道 0..1
+   */
+  b: number;
+  /**
+   * 透明度 0..1（tint 语境下即着色浓度）
+   */
+  a: number;
+};
+/**
+ * 预设标识
+ *
+ * - apple：Apple 2025 默认观感（克制折射 + 细腻色散 + 明亮边缘高光）
+ * - standard：标准模式，均匀边缘折射带（rdev standard）
+ * - polar：极坐标模式，径向渐强的折射分布（rdev polar）
+ * - prominent：强烈模式，宽折射带 + 高位移（rdev prominent）
+ * - frosted：磨砂模式，强模糊 + 弱折射
+ * - lens：透镜模式，高折射 + 高色散的放大镜观感
+ */
+type GlassPresetId = 'apple' | 'standard' | 'polar' | 'prominent' | 'frosted' | 'lens';
+/**
+ * 液态玻璃完整参数（解析后的形态，字段全部必填）
+ */
+type LiquidGlassParams = {
+  /**
+   * 形状类别
+   */
+  shape: GlassShapeKind;
+  /**
+   * 形状外接宽度（px）
+   */
+  width: number;
+  /**
+   * 形状外接高度（px）
+   */
+  height: number;
+  /**
+   * 圆角半径（px）
+   */
+  cornerRadius: number;
+  /**
+   * squircle 角平滑度 0..1
+   */
+  cornerSmoothing: number;
+  /**
+   * 基础折射强度 0..1
+   */
+  refraction: number;
+  /**
+   * 折射带宽度（px，从边界向内）
+   */
+  refractionHeight: number;
+  /**
+   * bevel 斜面强度 0..1
+   */
+  bevel: number;
+  /**
+   * bevel 幂次（边缘陡峭度）
+   */
+  bevelExponent: number;
+  /**
+   * 色散强度 0..1
+   */
+  dispersion: number;
+  /**
+   * 背景模糊半径（px）
+   */
+  blur: number;
+  /**
+   * 霜化（磨砂颗粒）强度 0..1
+   */
+  frost: number;
+  /**
+   * 着色（RGBA，a 为浓度）
+   */
+  tint: RGBA;
+  /**
+   * 背景饱和度系数（1 = 不变，>1 增饱和）
+   */
+  saturation: number;
+  /**
+   * 背景亮度系数（1 = 不变）
+   */
+  brightness: number;
+  /**
+   * 边缘高光强度 0..1
+   */
+  specular: number;
+  /**
+   * 边缘高光锐度（幂次）
+   */
+  specularExponent: number;
+  /**
+   * 弹性形变系数 0..1（指针交互的方向性拉伸，0 = 关闭）
+   */
+  elasticity: number;
+};
+/**
+ * 参数输入形态：预设 + 任意覆盖（适配层 props 直传）
+ */
+type LiquidGlassParamsInput = Partial<LiquidGlassParams> & {
+  /**
+   * 预设标识（缺省 apple）
+   */
+  preset?: GlassPresetId;
+};
+//#endregion
+//#region src/params/params.utils.d.ts
+/**
+ * 解析参数输入为完整参数（预设 + 覆盖 + 钳制）
+ *
+ * @param input - 参数输入（缺省使用 apple 预设）
+ * @returns 字段完整的液态玻璃参数
+ */
+declare function resolveParams(input?: LiquidGlassParamsInput): LiquidGlassParams;
+/**
+ * 按文档范围钳制参数数值字段
+ *
+ * @param params - 待钳制参数
+ * @returns 钳制后的新参数对象（不修改入参）
+ */
+declare function clampParams(params: LiquidGlassParams): LiquidGlassParams;
+/**
+ * 参数浅比较（tint 深比较），供适配层判断是否需要热更新
+ *
+ * @param a - 左参数
+ * @param b - 右参数
+ * @returns 字段全等时为 true
+ */
+declare function isParamsEqual(a: LiquidGlassParams, b: LiquidGlassParams): boolean;
+//#endregion
+//#region src/params/presets.constants.d.ts
+/**
+ * 预设表：每个预设都是字段完整的参数对象
+ */
+/**
+ * 默认预设（apple）
+ */
+declare const DEFAULT_PRESET: LiquidGlassParams;
+/**
+ * 预设表：每个预设都是字段完整的参数对象
+ */
+declare const GLASS_PRESETS: Record<GlassPresetId, LiquidGlassParams>;
+/**
+ * 默认预设标识
+ */
+declare const DEFAULT_PRESET_ID: GlassPresetId;
+//#endregion
+//#region src/render/renderer.types.d.ts
+/**
+ * 渲染后端标识
+ *
+ * - svg-filter：SVG feDisplacementMap 路线（最佳兼容）
+ * - webgl：WebGL 路线（最强表现力）
+ * - webgpu：WebGPU 路线（下一代，experimental）
+ * - css-backdrop：CSS backdrop-filter 降级路线（保底）
+ */
+type RendererBackend = 'svg-filter' | 'webgl' | 'webgpu' | 'css-backdrop';
+/**
+ * 容器尺寸（CSS 像素）
+ */
+type LiquidGlassSize = {
+  /**
+   * 宽度（px）
+   */
+  width: number;
+  /**
+   * 高度（px）
+   */
+  height: number;
+};
+/**
+ * 渲染器能力描述（装配层能力检测报告的数据来源）
+ */
+type RendererCapability = {
+  /**
+   * 后端标识
+   */
+  backend: RendererBackend;
+  /**
+   * 是否支持折射位移
+   */
+  supportsRefraction: boolean;
+  /**
+   * 是否支持色散
+   */
+  supportsDispersion: boolean;
+  /**
+   * 是否支持背景模糊
+   */
+  supportsBlur: boolean;
+  /**
+   * 是否支持边缘高光
+   */
+  supportsSpecular: boolean;
+  /**
+   * 是否支持直接采样 DOM 背景（无需显式背景源）
+   */
+  supportsDomBackdrop: boolean;
+  /**
+   * 实验性说明（非实验后端为 undefined）
+   */
+  experimental?: string;
+};
+/**
+ * 背景亮度统计（liquid-dom 的 adaptive tint 数据源）
+ */
+type BackdropMetrics = {
+  /**
+   * 平均亮度（线性空间 0..1）
+   */
+  averageLuminance: number;
+  /**
+   * 亮度中位数 P50（抗抖动的自适应色调推荐输入）
+   */
+  luminanceP50: number;
+  /**
+   * 亮度 P90（高光参考）
+   */
+  luminanceP90: number;
+};
+/**
+ * 背景源策略：向渲染器供给玻璃背后的像素
+ *
+ * 帧类型由实现方与渲染器约定（如 HTMLCanvasElement / ImageBitmap / GPUTexture），
+ * core 不约束其形态（零平台依赖）。
+ *
+ * @typeParam TFrame - 背景帧句柄类型（由 BackdropSource 实现方与渲染器约定）
+ */
+type BackdropSource<TFrame = unknown> = {
+  /**
+   * 背景源标识（调试与复用）
+   */
+  readonly id: string;
+  /**
+   * 捕获当前背景帧
+   *
+   * @returns 帧句柄（同步或异步）
+   */
+  capture(): TFrame | Promise<TFrame>;
+  /**
+   * 释放背景源持有的资源
+   */
+  dispose(): void;
+};
+/**
+ * 渲染上下文（工厂入参）
+ */
+type LiquidGlassRenderContext = {
+  /**
+   * 初始参数（已解析的完整形态）
+   */
+  params: LiquidGlassParams;
+  /**
+   * 初始尺寸
+   */
+  size: LiquidGlassSize;
+};
+/**
+ * 液态玻璃渲染器（策略接口）
+ *
+ * @typeParam TTarget - 渲染目标句柄类型（如 DOM 元素或原生视图）
+ */
+type LiquidGlassRenderer<TTarget = unknown> = {
+  /**
+   * 后端标识
+   */
+  readonly backend: RendererBackend;
+  /**
+   * 挂载到目标（DOM 元素 / 原生视图等平台句柄）
+   *
+   * @param target - 平台目标句柄
+   */
+  mount(target: TTarget): void;
+  /**
+   * 热更新参数（不重建实例）
+   *
+   * @param params - 完整参数
+   */
+  update(params: LiquidGlassParams): void;
+  /**
+   * 尺寸变化通知
+   *
+   * @param size - 新尺寸
+   */
+  resize(size: LiquidGlassSize): void;
+  /**
+   * 获取能力描述
+   *
+   * @returns 能力描述
+   */
+  getCapabilities(): RendererCapability;
+  /**
+   * 卸载并释放全部资源（幂等）
+   */
+  unmount(): void;
+};
+/**
+ * 渲染器工厂（后端包的导出形态）
+ *
+ * @typeParam TTarget - 渲染目标句柄类型（如 DOM 元素或原生视图）
+ */
+type LiquidGlassRendererFactory<TTarget = unknown> = (context: LiquidGlassRenderContext) => LiquidGlassRenderer<TTarget>;
+//#endregion
+export { type BackdropMetrics, type BackdropSource, type ChannelDisplacements, DEFAULT_PRESET, DEFAULT_PRESET_ID, GLASS_PRESETS, type GlassPresetId, type GlassShapeDescriptor, type GlassShapeKind, type HeightProfileParams, type LiquidGlassParams, type LiquidGlassParamsInput, type LiquidGlassRenderContext, type LiquidGlassRenderer, type LiquidGlassRendererFactory, type LiquidGlassSize, type RGBA, type RefractionParams, type RendererBackend, type RendererCapability, SPECTRAL_WEIGHTS, type ScalarField, type SpectralDispersionScales, type SpecularParams, type Vec2, addVec2, channelDispersionScales, channelDisplacements, circleMap, clampParams, dotVec2, dualRimSpecular, edgeFactor, edgeHeightProfile, fieldGradient, heightFieldNormal, isParamsEqual, lengthVec2, maxDisplacement, normalizeVec2, refractionDisplacement, resolveParams, rimFalloff, rimSpecular, scaleVec2, sdCircle, sdPill, sdRoundedRect, sdRoundedRectSmooth, sdShape, sdfOutwardNormal, spectralDisplacement, subVec2, vec2 };

package/dist/index.js

@@ -0,0 +1 @@
+const e=1e-6;function t(e,t,n){return Math.hypot(e,t)-n}function n(t,n,r,i){let a=Math.max(Math.min(r,i)/2,e),o=Math.max(Math.abs(r-i)/2,0);if(r>=i){let e=Math.min(Math.max(t,-o),o);return Math.hypot(t-e,n)-a}let s=Math.min(Math.max(n,-o),o);return Math.hypot(t,n-s)-a}function r(e,t,n,r,i){let a=Math.abs(e)-(n-i),o=Math.abs(t)-(r-i);return Math.hypot(Math.max(a,0),Math.max(o,0))+Math.min(Math.max(a,o),0)-i}function i(e,t,n,r,i,a){let o=Math.min(Math.max(a,0),1),s=2+o*6,c=Math.abs(e)-(n-i),l=Math.abs(t)-(r-i),u=Math.max(c,0),d=Math.max(l,0);return(o===0?Math.hypot(u,d):(u**+s+d**+s)**(1/s))+Math.min(Math.max(c,l),0)-i}function a(r,a,o){switch(o.kind){case`circle`:return t(r,a,Math.min(o.width,o.height)/2);case`pill`:return n(r,a,o.width,o.height);default:{let t=o.width/2,n=o.height/2;return i(r,a,t,n,Math.min(o.radius,Math.min(t,n)-e),o.smoothing)}}}function o(e,t){return{x:e,y:t}}function s(e,t){return{x:e.x+t.x,y:e.y+t.y}}function c(e,t){return{x:e.x-t.x,y:e.y-t.y}}function l(e,t){return{x:e.x*t,y:e.y*t}}function u(e,t){return e.x*t.x+e.y*t.y}function d(e){return Math.hypot(e.x,e.y)}function f(e){let t=d(e);return t===0?{x:0,y:0}:{x:e.x/t,y:e.y/t}}const p=.5;function m(e,t,n,r=p){return o((e(t+r,n)-e(t-r,n))/(2*r),(e(t,n+r)-e(t,n-r))/(2*r))}function h(e,t,n,r=p){return f(m(e,t,n,r))}function g(e,t,n,r=p){let i=m(e,t,n,r);return f(o(-i.x,-i.y))}function _(e){let t=Math.min(Math.max(e,0),1);return 1-Math.sqrt(1-t*t)}function v(e,t){if(t<=0)return+(e>=0);let n=1+e/t;return Math.min(Math.max(n,0),1)}function y(e,t){let n=v(e,t.refractionHeight);return t.refraction*_(n)+t.bevel*n**+t.bevelExponent}function b(e,t,n){return l(t,-(y(e,n)*n.refractionHeight*n.displacementScale))}function x(e){return(e.refraction+e.bevel)*e.refractionHeight*e.displacementScale}const S=[.175,.15,.145,.14,.135,.13,.125];function C(e){let t=Math.min(Math.max(e,0),1);return{r:1-.5*t,g:1,b:1+.7*t}}function w(e,t){let n=C(t);return{r:l(e,n.r),g:l(e,n.g),b:l(e,n.b)}}function T(e,t){let n=Math.min(Math.max(t,0),1),r=o(0,0);for(let t=0;t<S.length;t+=1){let i=1+(-.5+1.2*(t/(S.length-1)))*n;r=s(r,l(e,i*(S[t]??0)))}return r}function E(e,t){return Math.min(Math.max(e,0),1)**+t}function D(e,t,n){let r=f(t);return n.specular*E(u(e,r),n.specularExponent)}function O(e,t,n){return D(e,t,n)+D(e,{x:-t.x,y:-t.y},{...n,specular:n.specular*.5})}const k={shape:`rounded-rect`,width:320,height:200,cornerRadius:32,cornerSmoothing:.6,refraction:.35,refractionHeight:70,bevel:.25,bevelExponent:10,dispersion:.12,blur:2,frost:0,tint:{r:1,g:1,b:1,a:.08},saturation:1.4,brightness:1.05,specular:.6,specularExponent:24,elasticity:.15},A={apple:k,standard:{shape:`rounded-rect`,width:320,height:200,cornerRadius:24,cornerSmoothing:0,refraction:.3,refractionHeight:60,bevel:.15,bevelExponent:8,dispersion:.08,blur:1,frost:0,tint:{r:1,g:1,b:1,a:.05},saturation:1.25,brightness:1.02,specular:.45,specularExponent:20,elasticity:.1},polar:{shape:`rounded-rect`,width:320,height:200,cornerRadius:40,cornerSmoothing:.3,refraction:.45,refractionHeight:96,bevel:.2,bevelExponent:10,dispersion:.14,blur:2,frost:0,tint:{r:1,g:1,b:1,a:.06},saturation:1.35,brightness:1.04,specular:.5,specularExponent:22,elasticity:.15},prominent:{shape:`rounded-rect`,width:320,height:200,cornerRadius:28,cornerSmoothing:.2,refraction:.7,refractionHeight:110,bevel:.4,bevelExponent:9,dispersion:.22,blur:3,frost:.05,tint:{r:1,g:1,b:1,a:.08},saturation:1.5,brightness:1.08,specular:.65,specularExponent:18,elasticity:.2},frosted:{shape:`rounded-rect`,width:320,height:200,cornerRadius:24,cornerSmoothing:.4,refraction:.15,refractionHeight:40,bevel:.1,bevelExponent:8,dispersion:.04,blur:14,frost:.6,tint:{r:1,g:1,b:1,a:.12},saturation:1.2,brightness:1.1,specular:.3,specularExponent:16,elasticity:.08},lens:{shape:`circle`,width:220,height:220,cornerRadius:110,cornerSmoothing:0,refraction:.85,refractionHeight:90,bevel:.3,bevelExponent:12,dispersion:.3,blur:0,frost:0,tint:{r:1,g:1,b:1,a:.02},saturation:1.15,brightness:1,specular:.75,specularExponent:30,elasticity:0}},j=`apple`;function M(e,t,n){return Math.min(Math.max(e,t),n)}function N(e){let t=A[e?.preset??`apple`]??k,{preset:n,...r}=e??{};return P({...t,...r})}function P(e){return{...e,width:Math.max(e.width,1),height:Math.max(e.height,1),cornerRadius:Math.max(e.cornerRadius,0),cornerSmoothing:M(e.cornerSmoothing,0,1),refraction:M(e.refraction,0,1),refractionHeight:Math.max(e.refractionHeight,0),bevel:M(e.bevel,0,1),bevelExponent:M(e.bevelExponent,1,32),dispersion:M(e.dispersion,0,1),blur:Math.max(e.blur,0),frost:M(e.frost,0,1),tint:{r:M(e.tint.r,0,1),g:M(e.tint.g,0,1),b:M(e.tint.b,0,1),a:M(e.tint.a,0,1)},saturation:Math.max(e.saturation,0),brightness:Math.max(e.brightness,0),specular:M(e.specular,0,1),specularExponent:M(e.specularExponent,1,64),elasticity:M(e.elasticity,0,1)}}function F(e,t){return e.shape!==t.shape||e.width!==t.width||e.height!==t.height||e.cornerRadius!==t.cornerRadius||e.cornerSmoothing!==t.cornerSmoothing||e.refraction!==t.refraction||e.refractionHeight!==t.refractionHeight||e.bevel!==t.bevel||e.bevelExponent!==t.bevelExponent||e.dispersion!==t.dispersion||e.blur!==t.blur||e.frost!==t.frost||e.saturation!==t.saturation||e.brightness!==t.brightness||e.specular!==t.specular||e.specularExponent!==t.specularExponent||e.elasticity!==t.elasticity?!1:e.tint.r===t.tint.r&&e.tint.g===t.tint.g&&e.tint.b===t.tint.b&&e.tint.a===t.tint.a}export{k as DEFAULT_PRESET,j as DEFAULT_PRESET_ID,A as GLASS_PRESETS,S as SPECTRAL_WEIGHTS,s as addVec2,C as channelDispersionScales,w as channelDisplacements,_ as circleMap,P as clampParams,u as dotVec2,O as dualRimSpecular,v as edgeFactor,y as edgeHeightProfile,m as fieldGradient,g as heightFieldNormal,F as isParamsEqual,d as lengthVec2,x as maxDisplacement,f as normalizeVec2,b as refractionDisplacement,N as resolveParams,E as rimFalloff,D as rimSpecular,l as scaleVec2,t as sdCircle,n as sdPill,r as sdRoundedRect,i as sdRoundedRectSmooth,a as sdShape,h as sdfOutwardNormal,T as spectralDisplacement,c as subVec2,o as vec2};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@longzai-intelligence-liquid-glass/core",
+  "version": "0.0.1",
+  "description": "Liquid Glass 框架无关核心：形状 SDF、光学剖面、参数模型与渲染器抽象接口",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "lzi-bun-cli test",
+    "test:watch": "lzi-bun-cli test --watch",
+    "test:coverage": "lzi-bun-cli test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {},
+  "packageManager": "bun@1.3.14"
+}