@blendviewer/vision-scope 0.1.0 → 0.1.1

package/README.md

@@ -35,6 +35,7 @@ await scope.load('https://example.com/path/to/file.glb');
 Try the live playground: **[vision-scope.blendviewer.com](https://vision-scope.blendviewer.com)**
 
 - [PDF Document](https://vision-scope.blendviewer.com/?file=https://oss.blendviewer.com/public/788d77d0-1d49-11ef-861a-b3174c760332/math/9912/9912227v2.pdf)
+- [PPTX Powerpoint](https://vision-scope.blendviewer.com/?file=https://oss.blendviewer.com/public/57f41350-1e82-11ef-b5e1-03b42f41a1d3/examples/SMART-Animals.pptx)
 - [3D Model (GLB)](https://vision-scope.blendviewer.com/?file=https://oss.blendviewer.com/public/57f41350-1e82-11ef-b5e1-03b42f41a1d3/bee.glb)
 
 Share links with `?file=` query parameters, for example:
@@ -53,7 +54,7 @@ Vision Scope comes with built-in renderers for a wide variety of file formats:
 - **CAD**: `dwg`, `dxf`
 - **Point Cloud**: `pcd`, `ply`, `las`
 - **GPU Textures**: `ktx2`, `basis`
-- **Documents**: `pdf`, `docx`, `doc`, `pptx`, `ppt`, `txt`, `md`
+- **Documents**: `pdf`, `doc`, `pptx`, `ppt`, `txt`, `md` — `.docx` via Hub plugin `com.blendviewer.vision-docx`
 - **Tabular / Spreadsheets**: `csv`, `tsv`, `xlsx`, `xls`, `ods`
 - **Media (Video/Audio)**: `mp4`, `webm`, `avi`, `mov`, `mkv`, `mp3`, `wav`, `flac`, `aac`, `ogg`
 - **Code & Text**: `js`, `ts`, `jsx`, `tsx`, `py`, `java`, `go`, `rs`, `c`, `cpp`, `html`, `css`, `json`, `yaml`, `xml`, `sql`, `sh`, `dockerfile`, and many more.
@@ -61,35 +62,36 @@ Vision Scope comes with built-in renderers for a wide variety of file formats:
 
 ## Scope Extensions (Plugins)
 
-Vision Hub plugins can extend file preview capabilities beyond built-in types. You can export an extension from your plugin module:
+Hub plugins declare handled formats in **`scopeExtension.formats[]`** (one object per extension). Do not add plugin-only types to `FileTypeDetector`.
 
 ```javascript
 export const scopeExtension = {
   id: 'com.example.my-viewer',
-  extensions: ['h5', 'hdf5'],
+  formats: [
+    { ext: 'docx', kind: 'document', subtype: 'word', mime: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' },
+  ],
   mountPreview(container, context) {
-    // context.url, context.filename, context.readOnly, etc.
-    // Initialize your custom viewer here
-
-    return {
-      destroy() {
-        // Cleanup resources when the viewer is unmounted
-      },
-    };
+    return { destroy() {} };
   },
 };
 ```
 
-Register the extension at runtime:
+Register at runtime:
 
 ```javascript
 import { VisionScope } from '@blendviewer/vision-scope';
 
-// Register a static extension object
 VisionScope.registerExtension(scopeExtension);
-
-// Or register via dynamic import
 await VisionScope.registerExtensionModule(() => import('./path/to/plugin.js'));
 ```
 
-Built-in routing uses a file type detector first; unknown extensions fall through to the extension registry.
+| Field | Required | Purpose |
+|-------|----------|---------|
+| `formats[].ext` | yes | Extension without dot — routing + detection |
+| `formats[].kind` | yes | Semantic category (`document`, `tabular`, `spatial`, …) |
+| `formats[].mime` | no | MIME routing when extension is missing |
+| `formats[].subtype` | no | Display / logging hint |
+| `rendererKey` | no | RendererFactory key; defaults to `scope:<id>` |
+| `mountPreview` | yes* | Preview UI (*or `createRendererClass`) |
+
+Built-in types stay in `FileTypeDetector`. Hosts use `detectFileTypeFromExtension()` and `archiveFileIconSvg()` to merge built-in + plugin metadata.