artifactuse 0.1.23 → 0.1.25

package/README.md

@@ -531,6 +531,7 @@ const {
   // Programmatic API
   openFile,           // Open file in panel (auto-detect language from extension)
   openCode,           // Open code in panel (explicit language)
+  updateFile,          // Update existing artifact's code and refresh panel
   clearArtifacts,     // Clear all artifacts
 
   // Panel management
@@ -594,17 +595,36 @@ provideArtifactuse({
   // Code Editor (Optional) — CodeMirror 6 for the edit tab
   // Requires: @codemirror/state, @codemirror/view, @codemirror/commands,
   //           @codemirror/language, @codemirror/autocomplete
-  // Optional: @codemirror/lang-javascript, @codemirror/lang-python, @lezer/highlight
+  // Optional: language packages and @lezer/highlight (for syntax highlighting)
   editor: {
     modules: {
+      // Required
       state: cmState,                       // @codemirror/state
       view: cmView,                         // @codemirror/view
       commands: cmCommands,                 // @codemirror/commands
       language: cmLanguage,                 // @codemirror/language
       autocomplete: cmAutocomplete,         // @codemirror/autocomplete
-      langJavascript: cmLangJavascript,     // @codemirror/lang-javascript
+      // Syntax highlighting (optional)
+      lezerHighlight: lezerHighlight,       // @lezer/highlight
+      // Language packages (all optional — add only what you need)
+      langJavascript: cmLangJavascript,     // @codemirror/lang-javascript (js/jsx/ts/tsx)
       langPython: cmLangPython,             // @codemirror/lang-python
-      lezerHighlight: lezerHighlight,       // @lezer/highlight (for syntax colors)
+      langHtml: cmLangHtml,                 // @codemirror/lang-html
+      langCss: cmLangCss,                   // @codemirror/lang-css
+      langJson: cmLangJson,                 // @codemirror/lang-json
+      langMarkdown: cmLangMarkdown,         // @codemirror/lang-markdown
+      langXml: cmLangXml,                   // @codemirror/lang-xml
+      langYaml: cmLangYaml,                 // @codemirror/lang-yaml
+      langSql: cmLangSql,                   // @codemirror/lang-sql
+      langJava: cmLangJava,                 // @codemirror/lang-java
+      langCpp: cmLangCpp,                   // @codemirror/lang-cpp (c/c++)
+      langGo: cmLangGo,                     // @codemirror/lang-go
+      langRust: cmLangRust,                 // @codemirror/lang-rust
+      langPhp: cmLangPhp,                   // @codemirror/lang-php
+      langVue: cmLangVue,                   // @codemirror/lang-vue
+      langAngular: cmLangAngular,           // @codemirror/lang-angular
+      langLess: cmLangLess,                 // @codemirror/lang-less
+      langSass: cmLangSass,                 // @codemirror/lang-sass (sass/scss)
     },
     theme: 'dark', // 'dark' | 'light' | 'auto'
   },
@@ -739,6 +759,31 @@ openCode(pythonCode, 'python', { title: 'My Script', tabs: ['code', 'edit'] });
 
 > **Note:** If the language has no registered panel, it falls back to `txt` (plain text) in the code panel.
 
+### updateFile
+
+Updates an existing artifact's code in place and refreshes the panel (no duplicate tabs):
+
+```js
+const { openFile, updateFile } = useArtifactuse();
+
+// First open — returns artifact reference
+const artifact = openFile('app.html', code, { panelUrl: '...' });
+
+// Later — update in place, refreshes iframe
+updateFile(artifact, newCode);
+updateFile(artifact.id, newCode, { panelUrl: newUrl });
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `artifact` | `object\|string` | Yes | Artifact object (from `openFile`) or artifact ID string |
+| `code` | `string` | Yes | New code content |
+| `options.title` | `string` | No | Update display title |
+| `options.tabs` | `string[]` | No | Update visible tabs |
+| `options.panelUrl` | `string` | No | Update custom iframe URL |
+
+> **Note:** `updateFile` triggers the `artifact:updated` event with `{ artifactId, artifact }`.
+
 ### clearArtifacts
 
 Removes all artifacts and closes the panel:

package/dist/core/index.d.ts

@@ -70,6 +70,7 @@ export function createArtifactuse(userConfig?: {}): {
         lineCount: number;
         createdAt: string;
     };
+    updateFile: (artifactOrId: any, code: any, options?: {}) => any;
     closePanel: () => void;
     togglePanel: () => void;
     toggleFullscreen: () => void;