graphwise-reactodia 0.0.1-TR11 → 0.0.1-TR13

package/dist/types/components/graphwise-reactodia/graphwise-reactodia.d.ts

@@ -34,9 +34,9 @@ export declare class GraphwiseReactodia {
     language: LanguageKey;
     /**
      * Query preset for the SPARQL data provider, owned and configured by the host. A DOM
-     * property (an object, not an attribute) passed in from outside the wrapper. When omitted,
-     * the data provider falls back to Reactodia's generic OWL/RDFS preset. Changing it rebuilds
-     * the data provider and resets the canvas.
+     * property (an object, not an attribute) passed in from outside the wrapper. Required: the
+     * wrapper has no default preset and throws when it is missing. Changing it rebuilds the data
+     * provider and reloads the graph with it, keeping the current diagram.
      */
     providerSettings?: SparqlDataProviderSettings;
     /**
@@ -47,8 +47,8 @@ export declare class GraphwiseReactodia {
      */
     theme?: string;
     private reactRoot?;
-    onProviderSettingsChange(): void;
-    onLanguageChange(): void;
+    onCurrentRepositoryChange(): void;
+    onLanguageOrSettingsChange(): void;
     onThemeChange(): void;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/types/components/graphwise-reactodia/menu/graphwise-menu.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The workspace main menu: Reactodia's default actions, followed by the diagram download and upload.
+ *
+ * Passing a `menu` to the `DefaultWorkspace` replaces its default actions, so they are listed here again.
+ * Rendered inside the workspace, so the actions can use the workspace hooks.
+ */
+export declare function GraphwiseMenu(): import("react").FunctionComponentElement<{
+    children?: import("react").ReactNode | undefined;
+}>;

package/dist/types/components/graphwise-reactodia/models/reactodia-app-props.d.ts

@@ -23,12 +23,12 @@ export interface ReactodiaAppProps {
      */
     language: LanguageKey;
     /**
-     * Query preset for the SPARQL data provider, owned and configured by the host. Falls back
-     * to Reactodia's generic `OwlRdfsSettings` OWL/RDFS preset when omitted.
+     * Query preset for the SPARQL data provider, owned and configured by the host.
      */
-    providerSettings?: SparqlDataProviderSettings;
+    providerSettings: SparqlDataProviderSettings;
     /**
-     * When true, the host is remounting the component switch languages, so the workspace should not be seeded, if a seed is present.
+     * When true, the host is remounting the component to switch languages or to apply new provider
+     * settings, so the workspace should not be seeded, if a seed is present.
      * Rather, the current state should simply be reloaded.
      */
     isReload?: boolean;

package/dist/types/components/graphwise-reactodia/reactodia-app.d.ts

@@ -6,8 +6,9 @@ import { ReactodiaAppProps } from './models/reactodia-app-props';
  */
 export declare function mountReactodia(container: HTMLElement, props: ReactodiaAppProps): Root;
 /**
- * Re-points the diagram at a new SPARQL endpoint or query preset by recreating it with a
- * fresh data provider. The canvas is reset to empty, matching the initial mount.
+ * Re-points the diagram at a new SPARQL endpoint by recreating it with a fresh data provider.
+ * The canvas is reset to empty, matching the initial mount, since the data of another repository
+ * has nothing to do with the current graph.
  */
 export declare function updateReactodia(props: ReactodiaAppProps): Promise<void>;
 /**

package/dist/types/components/graphwise-reactodia/services/diagram/diagram.service.d.ts

@@ -1,4 +1,4 @@
-import type { DataDiagramModel, SerializedDiagram } from '@reactodia/workspace';
+import type { DataDiagramModel, DataProvider, SerializedDiagram } from '@reactodia/workspace';
 import { Subscription } from '../../models/subscription';
 /**
  * Callback invoked with the current diagram layout whenever it changes.
@@ -11,6 +11,16 @@ export declare class DiagramService {
     static readonly ID = "DiagramService";
     private static readonly NOTIFY_DEBOUNCE_MS;
     private static readonly HISTORY_CHANGED_EVENT;
+    /**
+     * Replaces the diagram content with the given serialization. Element data is requested from the data provider and
+     * the links between the imported elements are validated against it.
+     *
+     * @param model The diagram model to import into.
+     * @param dataProvider The data provider to bind to the diagram.
+     * @param diagram The serialization to import. When `undefined`, the diagram is cleared.
+     * @param signal Optional signal to abort the import.
+     */
+    importDiagram(model: DataDiagramModel, dataProvider: DataProvider, diagram: SerializedDiagram | undefined, signal?: AbortSignal): Promise<void>;
     /**
      * Subscribes to diagram changes. On every debounced change the current layout is
      * exported and passed to the callback.

package/dist/types/components/graphwise-reactodia/services/diagram-file/diagram-file.service.d.ts

@@ -0,0 +1,24 @@
+import type { SerializedDiagram } from '@reactodia/workspace';
+/**
+ * Service for downloading and uploading the diagram as a file. The file content is the same
+ * {@link SerializedDiagram} that is persisted to the local store.
+ */
+export declare class DiagramFileService {
+    static readonly ID = "DiagramFileService";
+    static readonly FILE_EXTENSION = ".json";
+    private static readonly MIME_TYPE;
+    /**
+     * Downloads the given diagram serialization as a file with the given name.
+     */
+    download(diagram: SerializedDiagram, fileName: string): void;
+    /**
+     * Reads a diagram serialization from the given file.
+     *
+     * @throws Error when the file is not valid JSON or is not a serialized diagram.
+     */
+    read(file: File): Promise<SerializedDiagram>;
+    /**
+     * Checks if the provided value is a serialized diagram
+     */
+    private isSerializedDiagram;
+}

package/dist/types/components.d.ts

@@ -36,7 +36,7 @@ export namespace Components {
          */
         "language": LanguageKey;
         /**
-          * Query preset for the SPARQL data provider, owned and configured by the host. A DOM property (an object, not an attribute) passed in from outside the wrapper. When omitted, the data provider falls back to Reactodia's generic OWL/RDFS preset. Changing it rebuilds the data provider and resets the canvas.
+          * Query preset for the SPARQL data provider, owned and configured by the host. A DOM property (an object, not an attribute) passed in from outside the wrapper. Required: the wrapper has no default preset and throws when it is missing. Changing it rebuilds the data provider and reloads the graph with it, keeping the current diagram.
          */
         "providerSettings"?: SparqlDataProviderSettings;
         /**
@@ -90,7 +90,7 @@ declare namespace LocalJSX {
          */
         "language"?: LanguageKey;
         /**
-          * Query preset for the SPARQL data provider, owned and configured by the host. A DOM property (an object, not an attribute) passed in from outside the wrapper. When omitted, the data provider falls back to Reactodia's generic OWL/RDFS preset. Changing it rebuilds the data provider and resets the canvas.
+          * Query preset for the SPARQL data provider, owned and configured by the host. A DOM property (an object, not an attribute) passed in from outside the wrapper. Required: the wrapper has no default preset and throws when it is missing. Changing it rebuilds the data provider and reloads the graph with it, keeping the current diagram.
          */
         "providerSettings"?: SparqlDataProviderSettings;
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphwise-reactodia",
-  "version": "0.0.1-TR11",
+  "version": "0.0.1-TR13",
   "description": "Graphwise wrapper around the Reactodia graph explorer.",
   "license": "LGPL-3.0-or-later",
   "author": "Ontotext AD",
@@ -46,7 +46,7 @@
     "@types/jest": "^29.5.14",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
-    "cypress": "^15.17.0",
+    "cypress": "15.17.0",
     "jest": "^29.7.0",
     "jest-cli": "^29.7.0",
     "react": "^18.3.1",