graphwise-reactodia 0.0.1-TR1 → 0.0.1-TR10

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

@@ -0,0 +1,26 @@
+import type { SerializedDiagram } from '@reactodia/workspace';
+/**
+ * Service for local store-related diagram operations
+ */
+export declare class DiagramStorageService {
+    static readonly ID = "DiagramStorageService";
+    private static readonly STORAGE_KEY;
+    /**
+     * Load the persisted diagram from the local store, or `undefined` when nothing is stored (or the stored value
+     * is unreadable).
+     */
+    load(): SerializedDiagram | undefined;
+    /**
+     * Persists the given diagram serialization.
+     */
+    save(diagram: SerializedDiagram): void;
+    /**
+     * Removes the persisted diagram. Used when a new view (a seed) should take precedence over
+     * previously saved edits.
+     */
+    clear(): void;
+    /**
+     * Local storage getter
+     */
+    private get storage();
+}

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

@@ -0,0 +1,14 @@
+import { Subscription } from '../../models/subscription';
+/**
+ * Service for event based operations
+ */
+export declare class EventService {
+    static readonly ID = "EventService";
+    /**
+     * Subscribes to the host's "clear persisted diagram" command.
+     *
+     * @param onClear Called whenever the event fires.
+     * @returns A {@link Subscription} that, when called, removes the listener.
+     */
+    subscribeToClearDiagramStorage(onClear: () => void): Subscription;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Service that provides access to browser window-related functionality.
+ */
+export declare class WindowService {
+    static readonly ID = "WindowService";
+    getWindow(): Window;
+}

package/dist/types/components/graphwise-reactodia/styles/type-style.resolver.d.ts

@@ -0,0 +1,11 @@
+import { TypeStyleResolver } from '@reactodia/workspace';
+/**
+ * Colors an element by its type: each type takes the next color from the palette, which wraps
+ * around once it runs out
+ *
+ * Returns `undefined` for elements without a type (placeholders and other non-entity elements) and
+ * when the host does not define the palette, leaving Reactodia to fall back to its own hash-based
+ * colors.
+ */
+export declare const resolveTypeStyle: TypeStyleResolver;
+export declare const resetColors: () => void;

package/dist/types/components/graphwise-reactodia/testing/storage.mock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal in-memory {@link Storage}, so services that read `localStorage` can be exercised
+ * without a real browser store and asserted against directly. Shared across test suites.
+ */
+export declare class StorageMock implements Storage {
+    private readonly store;
+    get length(): number;
+    clear(): void;
+    getItem(key: string): string | null;
+    key(index: number): string | null;
+    removeItem(key: string): void;
+    setItem(key: string, value: string): void;
+}
+/**
+ * Creates a fresh {@link StorageMock}. Suites install the returned instance as the global
+ * `localStorage` themselves.
+ */
+export declare function createStorageMock(): StorageMock;

package/dist/types/components.d.ts

@@ -5,45 +5,53 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { SparqlDataProviderSettings, SparqlQueryFunction } from "@reactodia/workspace";
-export { SparqlDataProviderSettings, SparqlQueryFunction } from "@reactodia/workspace";
+import { ReactodiaConfig } from "./components/graphwise-reactodia/models/reactodia-config";
+import { LanguageKey } from "./components/graphwise-reactodia/i18n/language-key";
+import { SparqlDataProviderSettings } from "@reactodia/workspace";
+export { ReactodiaConfig } from "./components/graphwise-reactodia/models/reactodia-config";
+export { LanguageKey } from "./components/graphwise-reactodia/i18n/language-key";
+export { SparqlDataProviderSettings } from "@reactodia/workspace";
 export namespace Components {
     /**
      * A web component that renders a graph with the Reactodia workspace.
      * The component is backed by a SPARQL endpoint but is endpoint-agnostic: the host passes
-     * the active repository's endpoint via `current-repository` and a `queryFunction` that
-     * performs the actual HTTP request. Reactodia fetches all node, link and type data lazily
-     * through them; the canvas starts empty and the user populates it via the search bar.
+     * the active repository's endpoint via `current-repository` and a `config.queryFunction`
+     * that performs the actual HTTP request. Reactodia fetches all node, link and type data
+     * lazily through them; the canvas starts empty and the user populates it via the search bar.
      * The component is a thin wrapper around Reactodia: query configuration lives outside the
      * wrapper and is supplied through the `providerSettings` prop.
      */
     interface GraphwiseReactodia {
         /**
-          * The active repository id. Appended to {@link queryFunction} as the request `url`; changing it re-points the graph at the new repository (and resets the canvas), which is how runtime repository changes are handled.
+          * Host-supplied configuration: the SPARQL `queryFunction` transport and an optional `seed` set of entities to pre-populate the canvas with. A DOM property (an object, not an attribute) passed in from outside the wrapper.  Read once on mount; not watched, as it only sets up the data source and initial canvas.
          */
-        "currentRepository": string;
+        "config"?: ReactodiaConfig;
+        /**
+          * The active repository id. Appended to {@link queryFunction } as the request `url`; changing it re-points the graph at the new repository (and resets the canvas), which is how runtime repository changes are handled.
+         */
+        "currentRepository"?: string;
         /**
           * UI language code (e.g. `en`, `fr`) for the Reactodia interface. Defaults to English.
-          * @default 'en'
+          * @default LanguageKey.EN
          */
-        "language": string;
+        "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.
          */
         "providerSettings"?: SparqlDataProviderSettings;
         /**
-          * HTTP transport for the SPARQL requests. Set by the host so requests go through the host's HTTP layer (auth, interceptors) instead of a built-in `fetch`.
+          * The theme currently applied by the host (e.g. `light`, `dark`). The value itself is never read - the node colors are taken from the host's CSS custom properties - it only signals that those values have changed. The host owns the theme, including whether it follows the OS color scheme, so the change is passed in instead of being detected here.
          */
-        "queryFunction": SparqlQueryFunction;
+        "theme"?: string;
     }
 }
 declare global {
     /**
      * A web component that renders a graph with the Reactodia workspace.
      * The component is backed by a SPARQL endpoint but is endpoint-agnostic: the host passes
-     * the active repository's endpoint via `current-repository` and a `queryFunction` that
-     * performs the actual HTTP request. Reactodia fetches all node, link and type data lazily
-     * through them; the canvas starts empty and the user populates it via the search bar.
+     * the active repository's endpoint via `current-repository` and a `config.queryFunction`
+     * that performs the actual HTTP request. Reactodia fetches all node, link and type data
+     * lazily through them; the canvas starts empty and the user populates it via the search bar.
      * The component is a thin wrapper around Reactodia: query configuration lives outside the
      * wrapper and is supplied through the `providerSettings` prop.
      */
@@ -61,30 +69,34 @@ declare namespace LocalJSX {
     /**
      * A web component that renders a graph with the Reactodia workspace.
      * The component is backed by a SPARQL endpoint but is endpoint-agnostic: the host passes
-     * the active repository's endpoint via `current-repository` and a `queryFunction` that
-     * performs the actual HTTP request. Reactodia fetches all node, link and type data lazily
-     * through them; the canvas starts empty and the user populates it via the search bar.
+     * the active repository's endpoint via `current-repository` and a `config.queryFunction`
+     * that performs the actual HTTP request. Reactodia fetches all node, link and type data
+     * lazily through them; the canvas starts empty and the user populates it via the search bar.
      * The component is a thin wrapper around Reactodia: query configuration lives outside the
      * wrapper and is supplied through the `providerSettings` prop.
      */
     interface GraphwiseReactodia {
         /**
-          * The active repository id. Appended to {@link queryFunction} as the request `url`; changing it re-points the graph at the new repository (and resets the canvas), which is how runtime repository changes are handled.
+          * Host-supplied configuration: the SPARQL `queryFunction` transport and an optional `seed` set of entities to pre-populate the canvas with. A DOM property (an object, not an attribute) passed in from outside the wrapper.  Read once on mount; not watched, as it only sets up the data source and initial canvas.
+         */
+        "config"?: ReactodiaConfig;
+        /**
+          * The active repository id. Appended to {@link queryFunction } as the request `url`; changing it re-points the graph at the new repository (and resets the canvas), which is how runtime repository changes are handled.
          */
         "currentRepository"?: string;
         /**
           * UI language code (e.g. `en`, `fr`) for the Reactodia interface. Defaults to English.
-          * @default 'en'
+          * @default LanguageKey.EN
          */
-        "language"?: string;
+        "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.
          */
         "providerSettings"?: SparqlDataProviderSettings;
         /**
-          * HTTP transport for the SPARQL requests. Set by the host so requests go through the host's HTTP layer (auth, interceptors) instead of a built-in `fetch`.
+          * The theme currently applied by the host (e.g. `light`, `dark`). The value itself is never read - the node colors are taken from the host's CSS custom properties - it only signals that those values have changed. The host owns the theme, including whether it follows the OS color scheme, so the change is passed in instead of being detected here.
          */
-        "queryFunction"?: SparqlQueryFunction;
+        "theme"?: string;
     }
     interface IntrinsicElements {
         "graphwise-reactodia": GraphwiseReactodia;
@@ -97,9 +109,9 @@ declare module "@stencil/core" {
             /**
              * A web component that renders a graph with the Reactodia workspace.
              * The component is backed by a SPARQL endpoint but is endpoint-agnostic: the host passes
-             * the active repository's endpoint via `current-repository` and a `queryFunction` that
-             * performs the actual HTTP request. Reactodia fetches all node, link and type data lazily
-             * through them; the canvas starts empty and the user populates it via the search bar.
+             * the active repository's endpoint via `current-repository` and a `config.queryFunction`
+             * that performs the actual HTTP request. Reactodia fetches all node, link and type data
+             * lazily through them; the canvas starts empty and the user populates it via the search bar.
              * The component is a thin wrapper around Reactodia: query configuration lives outside the
              * wrapper and is supplied through the `providerSettings` prop.
              */

package/dist/types/index.d.ts

@@ -1 +1 @@
-export {};
+export { CLEAR_DIAGRAM_STORAGE_EVENT } from './components/graphwise-reactodia/models/clear-diagram-storage-event';

package/package.json

@@ -1,30 +1,53 @@
 {
   "name": "graphwise-reactodia",
-  "version": "0.0.1-TR1",
+  "version": "0.0.1-TR10",
   "description": "Graphwise wrapper around the Reactodia graph explorer.",
   "license": "Apache-2.0",
   "author": "Ontotext AD",
   "main": "dist/index.cjs.js",
+  "module": "dist/esm/index.js",
   "collection": "dist/collection/collection-manifest.json",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./loader": {
+      "import": "./loader/index.js",
+      "require": "./loader/index.cjs.js",
+      "types": "./loader/index.d.ts"
+    }
+  },
   "files": [
     "dist/",
     "loader/"
   ],
   "scripts": {
-    "build": "stencil build",
-    "start": "stencil build --dev --watch --serve"
-  },
-  "dependencies": {
-    "@reactodia/workspace": "^0.34.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "reactodia:install": "cd reactodia-workspace && npm ci",
+    "reactodia:compile": "cd reactodia-workspace && npm run build && npm run typings",
+    "reactodia:build": "npm run reactodia:install && npm run reactodia:compile",
+    "build": "npm run reactodia:build && stencil build",
+    "start": "npm run reactodia:build && stencil build --dev --watch --serve",
+    "cy:open": "cypress open",
+    "cy:run": "cypress run",
+    "cy:run:ci": "docker compose --ansi never up --exit-code-from cypress",
+    "test": "stencil test --spec",
+    "test.watch": "stencil test --spec --watchAll"
   },
   "devDependencies": {
     "@rdfjs/types": "^2.0.1",
+    "@reactodia/workspace": "file:./reactodia-workspace",
     "@stencil/core": "4.35.1",
     "@stencil/sass": "^3.2.3",
+    "@types/jest": "^29.5.14",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
+    "cypress": "^15.17.0",
+    "jest": "^29.7.0",
+    "jest-cli": "^29.7.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "rollup-plugin-node-polyfills": "^0.2.1"
   }
 }