data-explorer-core

Core data model for Data Explorer: the parser, data model, and node schema for Simulink data-dictionary (.sldd), model (.slx), MAT-file (.mat), and project (.prj) files.

Presentation-independent and embeddable in-process. Used by the Simulink Data Explorer VS Code extension, and shared across other Data Explorer front-ends.

Install

npm install data-explorer-core

Usage

import { createSession } from 'data-explorer-core';

const session = createSession();
const src = session.addDataSource('params.sldd', slddJson);
session.getDataSourceIds();          // ['params.sldd']
session.editProperty(id, 'Value', 5);
session.undo();

Each createSession() returns an independent instance with its own data sources, node index, undo stacks, and event bus, so multiple sessions never share state. Stateless parsers (parseSlx, parseMat, parseProject, parseBinarySldd) are also exported for consumers that only need to parse a buffer.

Universal ingest

Instead of choosing an addXSource by type, hand core the content plus a filename and it sniffs (extension + magic bytes) and dispatches:

import { createSession, ingest, toDTO } from 'data-explorer-core';
const session = createSession();
const src = ingest(session, bytesOrTextOrObject, { filename: 'params.sldd' });
const snapshot = toDTO(src, { depth: 2 }); // JSON-safe; for RPC boundaries

ingest and toDTO are universal — no fs — so they run identically in the browser (uploaded ArrayBuffer) and in Node. toDTO projects a live node into a flat, serializable snapshot (child ids, not object references) for consumers that cross a process or network boundary; in-process consumers hold live nodes directly.

To load from a filesystem path, import the Node-only subpath (the only part of the package that touches fs; fenced out of browser bundles by exports):

import { createSession, loadFromPath, loadDirectory } from 'data-explorer-core/node';
const s = createSession();
loadFromPath(s, 'params.sldd');
loadDirectory(s, 'some_dir/');   // all .sldd/.slx/.mat/.prj into one session

License

BSD-3-Clause © The MathWorks, Inc.