wgsl-play 0.0.35 → 0.0.37

package/dist/WgslPlay-B86UkrM7.d.ts

@@ -0,0 +1,121 @@
+import { Conditions, LinkParams } from "wesl";
+
+//#region src/Config.d.ts
+/** Configuration for wgsl-play. */
+interface WgslPlayConfig {
+  /** Root path for internal imports (package::, super::). Default: "/shaders" */
+  shaderRoot: string;
+}
+/** Set global defaults for all wgsl-play instances. */
+declare function defaults(config: Partial<WgslPlayConfig>): void;
+/** Get resolved config, merging element overrides with global defaults. */
+declare function getConfig(overrides?: Partial<WgslPlayConfig>): WgslPlayConfig;
+/** Reset config to defaults (useful for testing). */
+declare function resetConfig(): void;
+//#endregion
+//#region src/WgslPlay.d.ts
+/** Project configuration for multi-file shaders (subset of wesl link() API). */
+type WeslProject = Pick<LinkParams, "weslSrc" | "rootModuleName" | "conditions" | "constants" | "libs" | "packageName">;
+/** One source location within a compile error. */
+interface CompileErrorLocation {
+  file?: string;
+  line: number;
+  column: number;
+  length?: number;
+  severity: "error" | "warning" | "info";
+  message: string;
+}
+/** Compile error detail for events. */
+interface CompileErrorDetail {
+  message: string;
+  source: "wesl" | "webgpu";
+  locations: CompileErrorLocation[];
+}
+/** <wgsl-play> web component for rendering WESL/WGSL fragment shaders.  */
+declare class WgslPlay extends HTMLElement {
+  static observedAttributes: string[];
+  private canvas;
+  private errorOverlay;
+  private controls;
+  private resizeObserver;
+  private stopRenderLoop?;
+  private renderState?;
+  private playback;
+  private _weslSrc;
+  private _rootModuleName;
+  private _libs?;
+  private _linkOptions;
+  private _fromFullProject;
+  private _initPromise?;
+  private _sourceEl;
+  private _sourceListener;
+  private _fetchLibs;
+  private _dirty;
+  private _building;
+  private _theme;
+  private _mediaQuery;
+  private _onFullscreenChange;
+  /** Get config overrides from element attributes. */
+  private getConfigOverrides;
+  constructor();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+  /** Current shader source code (main module). */
+  get source(): string;
+  /** Set shader source directly. */
+  set source(value: string);
+  /** Conditions for conditional compilation (@if/@elif/@else). */
+  get conditions(): Conditions;
+  set conditions(value: Conditions);
+  /** Set project configuration (mirrors wesl link() API). */
+  set project(value: WeslProject);
+  /** Set sources from a full project with weslSrc. */
+  private setProjectSources;
+  /** Whether to auto-fetch missing library packages from npm (default: true). */
+  get fetchLibs(): boolean;
+  set fetchLibs(value: boolean);
+  /** Whether autoplay is enabled (default: true). Set autoplay="false" to start paused. */
+  get autoplay(): boolean;
+  set autoplay(value: boolean | string);
+  /** Whether the shader is currently playing. */
+  get isPlaying(): boolean;
+  /** Current animation time in seconds. */
+  get time(): number;
+  /** Number of frames rendered (for testing/debugging). */
+  get frameCount(): number;
+  /** Whether there's a compilation error. */
+  get hasError(): boolean;
+  /** Current error message, or null if no error. */
+  get errorMessage(): string | null;
+  /** Start playback. */
+  play(): void;
+  /** Pause playback. */
+  pause(): void;
+  private setPlaying;
+  /** Reset animation to time 0 and pause. */
+  rewind(): void;
+  /** Display error message in overlay. Pass empty string to clear. */
+  showError(message: string): void;
+  /** Toggle fullscreen on this element. */
+  toggleFullscreen(): void;
+  private updateTheme;
+  /** Set up WebGPU and load initial shader. Returns true if successful. */
+  private initialize;
+  private doInitialize;
+  /** Load from source element, src URL, script child, or inline textContent. */
+  private loadInitialContent;
+  /** Connect to a source provider element (e.g., wgsl-edit). */
+  private connectToSource;
+  /** Fetch shader from URL, then trigger a build. */
+  private loadFromUrl;
+  /** Mark build as needed. Coalesces rapid requests into a single build. */
+  private requestBuild;
+  /** Run builds until no longer dirty. Only one instance runs at a time. */
+  private runBuild;
+  private handleCompileError;
+  /** Extract source locations from a WESL parse error or GPU compilation error. */
+  private extractLocations;
+}
+//#endregion
+export { WgslPlayConfig as a, resetConfig as c, WgslPlay as i, CompileErrorLocation as n, defaults as o, WeslProject as r, getConfig as s, CompileErrorDetail as t };