wgsl-edit 0.0.25 → 0.0.26

package/dist/WgslEdit.d.ts

@@ -3,6 +3,19 @@ import { Conditions, LinkParams, WeslBundle, WeslProject } from "wesl";
 //#region src/WgslEdit.d.ts
 type Theme = "light" | "dark" | "auto";
 type LintMode = "on" | "off";
+/** `autosave` CustomEvent detail: full project snapshot + dirty file names. */
+interface AutosaveDetail {
+  project: WeslProject;
+  dirty: string[];
+}
+/** Attributes accepted by `<wgsl-edit>` beyond standard HTML.
+ *  Source of truth for framework-specific JSX augmentations (see `./jsx-preact.ts`). */
+interface WgslEditAttrs {
+  /** Color theme; `"auto"` follows `prefers-color-scheme`. */
+  theme?: "light" | "dark" | "auto";
+  /** ID of an element (e.g. `<wgsl-play>`) to source compile diagnostics from. */
+  "lint-from"?: string;
+}
 declare class WgslEdit extends HTMLElement {
   static observedAttributes: string[];
   private editorView;
@@ -32,6 +45,10 @@ declare class WgslEdit extends HTMLElement {
   private _fetchingPkgs;
   private _fetchedPkgs;
   private _snackTimer;
+  private _devSaveListener;
+  private _saveTimer;
+  private _dirtyFiles;
+  private _switchingFile;
   private _externalDiagnostics;
   private _lintFromEl;
   /** Bound listeners for lint-from element's compile events. */
@@ -44,6 +61,8 @@ declare class WgslEdit extends HTMLElement {
   /** Conditions for conditional compilation (@if/@elif/@else). */
   get conditions(): Conditions;
   set conditions(value: Conditions);
+  /** Reconfigure a compartment via the active editor view (no-op if unmounted). */
+  private reconfigure;
   /** Active file content (single-file API). */
   get source(): string;
   /** Set active file content (single-file API). Auto-creates a default file entry. */
@@ -52,6 +71,7 @@ declare class WgslEdit extends HTMLElement {
   get sources(): Record<string, string>;
   /** Set all files (replaces existing). */
   set sources(value: Record<string, string>);
+  /** Snapshot of all editor state needed to link: sources, conditions, libs, root module. */
   get project(): WeslProject;
   set project(value: WeslProject);
   /** Link/compile WESL sources into WGSL. Returns the compiled WGSL string. */
@@ -75,6 +95,10 @@ declare class WgslEdit extends HTMLElement {
   /** GPU validation of linked WGSL (default: true). Set to false to disable. */
   get gpuLint(): boolean;
   set gpuLint(value: boolean);
+  /** Persist edits to disk via the dev-server save endpoint.
+   *  Requires `wgslEditAutosave()` to be installed in vite.config.ts. */
+  get autosave(): boolean;
+  set autosave(value: boolean);
   /** Whether to auto-fetch missing library packages from npm (default: true). */
   get fetchLibs(): boolean;
   set fetchLibs(value: boolean);
@@ -89,16 +113,34 @@ declare class WgslEdit extends HTMLElement {
   set theme(value: Theme);
   get shaderRoot(): string | null;
   set shaderRoot(value: string | null);
+  /** Add a new file and switch to it. No-op if `name` already exists. */
   addFile(name: string, content?: string): void;
+  /** Remove a file. No-op if it is missing or is the last remaining file. */
   removeFile(name: string): void;
+  /** Rename a file, preserving its document and editor state. No-op on collision. */
   renameFile(oldName: string, newName: string): void;
   /** Switch to a file, saving current state and restoring target state. */
   private switchToFile;
+  /** Build a fresh EditorState seeded with `doc` and the current extension set. */
+  private createFileState;
   private saveCurrentFileState;
+  private pkgName;
+  private activeModulePath;
   private dispatchChange;
   private dispatchFileChange;
+  private scheduleAutosave;
+  /** Dispatch an `autosave` event with a fresh project snapshot and the dirty-file list. */
+  private fireAutosave;
+  private enableDevSave;
+  private disableDevSave;
+  /** Built-in `autosave` listener: POST each dirty file to the dev-server save endpoint. */
+  private devSave;
+  /** One-shot disable on first failure: avoids spamming the console on every keystroke. */
+  private devSaveFailed;
+  /** First-time setup: read attributes, parse inline content, mount the EditorView. */
   private initEditor;
   private readInitialAttributes;
+  /** Assemble the full CodeMirror extension set for a fresh EditorState. */
   private buildExtensions;
   private resolveTheme;
   private updateTheme;
@@ -111,6 +153,7 @@ declare class WgslEdit extends HTMLElement {
   private updateLint;
   /** Listen for compile-error/compile-success events from a lint source element. */
   private connectLintSource;
+  /** Convert external compile-error locations into CodeMirror diagnostics for the active file. */
   private onCompileError;
   private onCompileSuccess;
   private resolveLineNumbers;
@@ -120,9 +163,10 @@ declare class WgslEdit extends HTMLElement {
   private renderTabs;
   private createTab;
   private createAddButton;
+  /** Replace the tab name span with an editable input; commit on Enter/blur, cancel on Escape. */
   private startRenameTab;
   private loadFromUrl;
   private loadInitialContent;
 }
 //#endregion
-export { WgslEdit };
+export { AutosaveDetail, WgslEdit, WgslEditAttrs };

package/dist/WgslEdit.js

@@ -1,3 +1,3 @@
 import "./Language.js";
-import { t as WgslEdit } from "./WgslEdit-ByXfb3R9.js";
+import { t as WgslEdit } from "./WgslEdit-CNK80480.js";
 export { WgslEdit };

package/dist/autosave.d.mts

@@ -0,0 +1,11 @@
+import { Plugin } from "vite";
+
+//#region src/autosave.d.ts
+interface WgslEditAutosaveOptions {
+  /** Disable the save endpoint without removing the plugin (default: enabled). */
+  disabled?: boolean;
+}
+/** Vite dev plugin: lets <wgsl-edit autosave> persist edits to disk via the save endpoint. */
+declare function wgslEditAutosave(options?: WgslEditAutosaveOptions): Plugin;
+//#endregion
+export { WgslEditAutosaveOptions, wgslEditAutosave as default };

package/dist/autosave.mjs

@@ -0,0 +1,18 @@
+import { pendingSaves, weslSaveMiddleware } from "./SaveMiddleware.mjs";
+//#region src/autosave.ts
+/** Vite dev plugin: lets <wgsl-edit autosave> persist edits to disk via the save endpoint. */
+function wgslEditAutosave(options) {
+	return {
+		name: "wgsl-edit-autosave",
+		apply: "serve",
+		configureServer(server) {
+			if (options?.disabled) return;
+			server.middlewares.use(weslSaveMiddleware(server.config.root));
+		},
+		hotUpdate({ file }) {
+			if (pendingSaves.delete(file)) return [];
+		}
+	};
+}
+//#endregion
+export { wgslEditAutosave as default };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { wesl, weslLanguage } from "./Language.js";
-import { t as WgslEdit } from "./WgslEdit-ByXfb3R9.js";
+import { t as WgslEdit } from "./WgslEdit-CNK80480.js";
 //#region src/index.ts
 if (!customElements.get("wgsl-edit")) customElements.define("wgsl-edit", WgslEdit);
 //#endregion

package/dist/jsx-preact.d.ts

@@ -0,0 +1,12 @@
+import { WgslEdit, WgslEditAttrs } from "./WgslEdit.js";
+import { HTMLAttributes } from "preact";
+
+//#region src/jsx-preact.d.ts
+type WgslEditTag = HTMLAttributes<WgslEdit> & WgslEditAttrs;
+declare module "preact" {
+  namespace JSX {
+    interface IntrinsicElements {
+      "wgsl-edit": WgslEditTag;
+    }
+  }
+}