wgsl-play 0.0.26 → 0.0.28

package/README.md

@@ -82,9 +82,11 @@ The `?raw` suffix imports the file as a string. This keeps shaders alongside you
 - `src` - URL to .wesl/.wgsl file
 - `shader-root` - Root path for internal imports (default: `/shaders`)
 - `autoplay` - Start animating on load (default: `true`). Set `autoplay="false"` to start paused
+- `transparent` - Use premultiplied alpha for transparent backgrounds (default: opaque)
 
 ### Properties
 - `source: string` - Get/set shader source
+- `conditions: Record<string, boolean>` - Get/set conditions for conditional compilation (`@if`/`@elif`/`@else`)
 - `project: WeslProject` - Set full project config (weslSrc, libs, conditions, constants)
 - `isPlaying: boolean` - Playback state (readonly)
 - `time: number` - Animation time in seconds (readonly)
@@ -192,4 +194,7 @@ import { WgslPlay } from "wgsl-play/element";
 import { defaults } from "wgsl-play";
 
 defaults({ shaderRoot: "/custom/shaders" });
+
+// Pre-bundled, all deps included
+import "wgsl-play/bundle";
 ```

package/dist/WgslPlay-BUiSUZem.d.ts

@@ -0,0 +1,115 @@
+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 _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 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, auto-fetching any imported dependencies. */
+  private loadFromUrl;
+  /** Rebuild GPU pipeline using stored state. For full projects with all sources. */
+  private rebuildPipeline;
+  /** Discover dependencies and rebuild. For HTTP/inline sources that may need fetching. */
+  private discoverAndRebuild;
+  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 };