@shulya/liquid-glass 0.0.0-stage → 1.0.0

package/types/index.d.ts

@@ -0,0 +1,80 @@
+export interface LiquidGlassOptions {
+  /**
+   * Optical rim bevel width in pixels (default: 16, min: 4, max: 48)
+   */
+  rim?: number;
+
+  /**
+   * Index of Refraction (default: 1.46, min: 1.05, max: 2.20)
+   */
+  ior?: number;
+
+  /**
+   * Optical surface height / thickness in pixels (default: 18, min: 2, max: 50)
+   */
+  height?: number;
+
+  /**
+   * Frosted blur intensity in pixels (default: 0, min: 0, max: 32)
+   */
+  frosted?: number;
+
+  /**
+   * Enable liquid coalescence with neighboring glass elements (default: true).
+   * Set to false for static/isolated blocks to bypass proximity checks and maximize performance.
+   */
+  fusion?: boolean;
+
+  /**
+   * Dynamically enable or pause the Liquid Glass optical effect (default: true).
+   */
+  enabled?: boolean;
+
+  /**
+   * Optional border radius override in pixels
+   */
+  borderRadius?: number | null;
+}
+
+export declare const OPTICAL_DEFAULTS: Readonly<{
+  rim: 16;
+  ior: 1.46;
+  height: 18;
+  frosted: 0;
+  fusion: true;
+}>;
+
+export declare const OPTICAL_LIMITS: Readonly<{
+  rim: Readonly<{ min: 4; max: 48 }>;
+  ior: Readonly<{ min: 1.05; max: 2.2 }>;
+  height: Readonly<{ min: 2; max: 50 }>;
+  frosted: Readonly<{ min: 0; max: 32 }>;
+}>;
+
+export declare function normalizeOptions(options?: LiquidGlassOptions): Required<LiquidGlassOptions>;
+
+export declare class LiquidGlassController {
+  element: HTMLElement;
+  options: Required<LiquidGlassOptions>;
+  constructor(element: HTMLElement, options?: LiquidGlassOptions);
+  isTouchingAny(threshold?: number): boolean;
+  update(newOptions: Partial<LiquidGlassOptions>): void;
+  refresh(): void;
+  destroy(): void;
+}
+
+export declare function createLiquidGlass(
+  target: string | HTMLElement,
+  options?: LiquidGlassOptions
+): LiquidGlassController;
+
+export declare function scheduleStageRedraw(): void;
+
+export declare function sampleTable(table: Float32Array, u: number): number;
+export declare function blendSurfaces(d1: number, d2: number, span: number): number;
+
+export declare const _T0: Float32Array;
+export declare const _T1: Float32Array;
+export declare const _T2: Float32Array;
+export declare const _T3: Float32Array;
+export declare const _T4: Float32Array;

package/types/react.d.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+import {
+  LiquidGlassOptions,
+  LiquidGlassController,
+  OPTICAL_DEFAULTS,
+  OPTICAL_LIMITS,
+  scheduleStageRedraw
+} from './index';
+
+export interface LiquidGlassProps
+  extends LiquidGlassOptions,
+    React.HTMLAttributes<HTMLElement>,
+    React.AnchorHTMLAttributes<HTMLAnchorElement>,
+    React.ButtonHTMLAttributes<HTMLButtonElement> {
+  as?: React.ElementType;
+  children?: React.ReactNode;
+  [key: string]: any;
+}
+
+export declare function useLiquidGlass<T extends HTMLElement = HTMLDivElement>(
+  options?: LiquidGlassOptions
+): React.MutableRefObject<T | null>;
+
+export declare const LiquidGlass: React.ForwardRefExoticComponent<
+  LiquidGlassProps & React.RefAttributes<HTMLElement>
+>;
+
+export { LiquidGlassController, OPTICAL_DEFAULTS, OPTICAL_LIMITS, scheduleStageRedraw };
+export default LiquidGlass;

package/types/solid.d.ts

@@ -0,0 +1,14 @@
+import { LiquidGlassOptions, LiquidGlassController } from './index';
+
+export declare function liquidGlass(
+  el: HTMLElement,
+  accessor: () => LiquidGlassOptions | LiquidGlassOptions
+): LiquidGlassController;
+
+export declare function LiquidGlass(
+  props: LiquidGlassOptions & { ref?: (el: HTMLElement) => void; children?: any }
+): any;
+
+export { LiquidGlassController };
+export default liquidGlass;
+

package/types/svelte.d.ts

@@ -0,0 +1,15 @@
+import { LiquidGlassOptions, LiquidGlassController } from './index';
+
+export interface SvelteActionReturn {
+  update: (newOptions?: LiquidGlassOptions) => void;
+  destroy: () => void;
+}
+
+export declare function liquidGlass(
+  node: HTMLElement,
+  options?: LiquidGlassOptions
+): SvelteActionReturn;
+
+export { LiquidGlassController };
+export default liquidGlass;
+

package/types/vue.d.ts

@@ -0,0 +1,19 @@
+import { Directive, DefineComponent, Plugin } from 'vue';
+import { LiquidGlassOptions, LiquidGlassController } from './index';
+
+export declare const vLiquidGlass: Directive<HTMLElement, LiquidGlassOptions>;
+
+export declare const LiquidGlass: DefineComponent<{
+  rim?: number;
+  ior?: number;
+  height?: number;
+  frosted?: number;
+  fusion?: boolean;
+  borderRadius?: number | null;
+  tag?: string;
+}>;
+
+export declare const LiquidGlassPlugin: Plugin;
+
+export { LiquidGlassController };
+export default LiquidGlass;