Repository navigation
Releases: Matdata-eu/MatGUI
Release list
v6.9.0
The editor now knows your endpoint: autocomplete suggests the classes and properties the endpoint actually uses, and hovering an IRI tells you what it is.
New features
- Class and property autocomplete from the endpoint (#195):
Ctrl+Spaceafteraor in a property position lists the classes and properties used in the current endpoint first, most used first with their usage count. The terms come from the Endpoint overview (VoID, the Classes/Properties results, or one small background query cached per endpoint). Picking one inserts the prefixed name and adds the missingPREFIX. Switch it off per endpoint in the Endpoint overview - Linked Open Vocabularies suggestions work again: the LOV API is broken, so MatGUI now ships the classes and properties of the most used LOV vocabularies and searches them in the browser. The ERA ontology is always included. LOV suggestions are inserted as prefixed names with their
PREFIX - IRI hover info (#196): hover an IRI or prefixed name in the editor to see its label, description, type and, for properties, domain and range. The information comes from a small query on the tab's endpoint, with a LOV lookup when the endpoint doesn't describe the IRI. Switch it off in Settings > Editor
- Pick the result view in the query (#134): a
#defaultView:<view>comment line opens the results in that view, like the Wikidata Query Service. View names match case-insensitively, and Wikidata names such asMapandBarChartopen the Geo and Chart views. Added prefixes now go below the comment lines at the top of a query, so the comment stays on the first line
Changes
- The snippets bar is no longer offered in the editor settings, since snippets are in the Insert menu and the Ctrl+K search. A value saved by that setting is ignored
Fixes
- Even spacing around the side panel's icon bar (#231)
- The default Light Theme didn't clearly show the selected text in the editor
For developers and embedders
- New Yasgui options
iriHoverandiriHoverLovFallback, andendpointDescribe.autocomplete: falseto turn off endpoint suggestions for all endpoints - New Yasqe options
iriHover,iriHoverDelay,endpointTermsandlovTerms(replace the bundled LOV list, ornullto leave out LOV suggestions), and agetIriAt(pos)method. Autocomplete hints can carry a detail, a section and prefixes to declare - The bundled LOV list lives in
packages/yasqe/src/lov-terms.json. Refresh it withnpm run util:fetchLov; a monthly "Refresh LOV terms" workflow opens a pull request with the update - Embedders can still show the snippets bar with
showSnippetsBar: true - Dependency updates:
query-string9 in yasqe, and Vite 8, esbuild 0.28 and Mocha 12 for development - Nothing was removed: existing config keys, methods and events keep working
Full Changelog: v6.8.0...v6.9.0
v6.8.0
A lighter, calmer MatGUI: each query now lives on one card, and a new search finds your saved queries, commands, snippets and settings with Ctrl+K.
Thanks to @miapb for the help with the redesign.
New features
- One query card: the query title, the editor and the results sit together on one card with no gap, separated by a thin line with a grip to resize them
- Title and breadcrumbs: the card shows the name of the query (double-click to rename it) and, for saved queries, the workspace and folders it is in and its version
- Saved status: saved queries show "✓ Saved", "Unsaved changes" or "Read-only" next to Run
- Editor toolbar: Prefixes, Insert, Share, Format, Save, Download, full screen and the layout toggle sit in a compact toolbar at the top right of the editor
- Search (Ctrl+K / ⌘K): find and open saved queries from all workspaces, insert code snippets, run commands (Run, New tab, Switch endpoint, Explore endpoint, Format, Share, Toggle side panel, dark mode and more) and open any settings section. Type
>to search commands and settings only - Side panel: a bar of icons stays on the left while the panel is closed. Ctrl+B / ⌘B shows or hides the panel, and Queries / Endpoint are now segmented tabs
- Describe panel: drag its left edge to make it wider, float it as a window you can move and resize, or maximize it. The width and position are remembered
- New look: pill-shaped tabs, the Geist font at 13px, quieter colours, MatData colours for SPARQL in the editor, and a compact results header, in light and dark mode
Fixes
- Full screen results now stay below the top bar, like the full screen editor, on a solid background
For developers and embedders
- New config option
showCommandPalette(defaulttrue) to hide the search and its Ctrl+K shortcut - New
yasgui.commandPalette,yasgui.queryBrowser.openQuery(workspaceId, queryId, label), and on tabsgetBreadcrumbs(),getSavedVersionLabel(),openInsertMenu(),insertPrefixes(),focusEndpoint(),getSnippets()andinsertSnippet() - New theme tokens:
--yasgui-surface-selected,--yasgui-line-soft,--yasgui-line-grip,--yasgui-ink-subtle,--yasgui-brand-fill,--yasgui-success,--yasgui-shadow-raise,--yasgui-shadow-sheet,--yasgui-shadow-overlay,--yasgui-scrimand--yasgui-font-size. All existing--yasgui-*variables keep working - The interface font is now Geist (it was Barlow). MatGUI loads no web fonts: load Geist and JetBrains Mono on your page to get the full look, otherwise the system font is used
- Nothing was removed: existing config keys, methods, classes such as
controlbar, events and persisted settings still work. The Prefixes, Insert and layout buttons moved from the query bar into the editor toolbar, and the Explore endpoint button moved to the side panel's icon bar (F8 still works)
Full Changelog: v6.7.0...v6.8.0
v6.7.0
A new look for MatGUI, in the MatData style, and upgraded table, geo, graph and chart viewer plugins.
New features
- New top bar with the tabs, plus help, theme and settings on the right
- New query bar: an endpoint picker with the quick-switch endpoints in its dropdown, Run (Ctrl+Enter) right next to it, and labelled Prefixes, Explore endpoint and Insert buttons
- Run turns into Stop while a query runs
- Code snippets moved into one Insert menu with search. The snippets bar is hidden by default and can be turned back on in the settings
- One side panel on the left with the saved queries and the endpoint overview. Pin it, fold it to a narrow rail, or resize it. F8 still opens the endpoint overview
- Managed queries show their saved version in the query bar
- New shared describe panel next to the results: outgoing and incoming triples, back and forward (Alt+← / Alt+→), click a resource to hop to it, raw response, Open as query and Copy IRI. All viewers use it
- All viewers put their controls in the same toolbar under the results header, with View settings on the right
- New MatData colours in light and dark mode, and Lucide icons throughout
Table viewer
- Describe opens in the shared describe panel and the controls move to the shared toolbar
Geo viewer
- Map settings move to the shared toolbar; zoom, layers and the time slider stay on the map
- Describe opens in the shared describe panel
- Emoji map buttons replaced by icons
Graph viewer
- Ctrl+click a node to describe it
- Controls move to the shared toolbar
- New node colours that match the map and chart
Chart viewer
- Chart selects move to the shared toolbar
- Describe opens in the shared describe panel
- First series in brand blue, hovered item in amber
For developers and embedders
- New plugin host API in YASR:
yasr.hostApi,yasr.describe(),yasr.closeDescribe(), thedescribeevent,yasr.getPluginToolbar()and theopenQueryInNewTabconfig hook. Plugins should feature-detectyasr.hostApi - New config key
helpUrl, newyasgui.sidePanelandtab.openSettings(), andyasqe.isQueryRunning().yasqe.insertSnippet()is now public - New theme tokens (
--yasgui-surface,--yasgui-ink,--yasgui-brand,--yasgui-highlight, radius, shadow and font tokens). All existing--yasgui-*variables keep working - Nothing was removed: existing config keys,
yasgui.queryBrowserandyasgui.endpointDescribemethods, events and persisted settings still work. Older plugin versions keep their own toolbar and describe window - MatGUI loads no web fonts; load Barlow and JetBrains Mono on your page to get the full look
Full Changelog: v6.6.0...v6.7.0
v6.6.0
Upgraded table and geo result viewer plugins.
Table viewer
New features
- Added clickable URIs in the describe modal: Ctrl+click describes a URI as subject, Ctrl+Shift+click as object, so you can hop from node to node
- Added back, forward and back-to-start buttons (and Alt+← / Alt+→) to the describe modal, to step through those hops
Geo viewer
New features
- Added back, forward and back-to-start buttons (and Alt+← / Alt+→) to the describe modal, to step through the IRIs reached by Ctrl+click
Full Changelog: v6.5.0...v6.6.0
v6.5.0
New features
- Added option to mark workspaces as readonly (fixes #187)
Fixes
- Updated geo viewer to fix issues with hover where label and hover color remained on geometry collections
Full Changelog: v6.4.1...v6.5.0
v6.4.1
v6.4.0
Upgraded table and geo result viewer plugins.
Table viewer
Fixes
- Right-click URI context menu not working when ellipsis is on for long URIs (fixes Matdata-eu/yasgui-table-plugin#23)
Geo viewer
New features
- Added Ctrl+click and Ctrl+Shift+click support to describe entities.
- Added hover highlighting and labels for features.
- Added a None basemap option and keyless layers, and removed the (API required) CartoDB option.
- Added openrailwaymap overlay
Fixes
- Fixed popup overflow so long IRIs and geometry literals stay visible inside the popup.
Full Changelog: v6.3.0...v6.4.0
v6.3.0
New features
- Added an "Endpoint overview" panel, opened with the new "Describe endpoint" button in the control bar or with F8. It shows the endpoint's service description and VoID dataset statistics (features, extension functions, named graphs, and class and property partitions). As well as on-demand overview queries to the endpoint panel for named graphs, triple counts, namespaces, classes, properties, SKOS concept schemes, SHACL/ShEx shapes, sample instances, hubs, languages, links, and time/geo data. Queries that can be slow are flagged.
- Added support for SPARQL 1.2 syntax in the editor: VERSION declarations, triple terms, reified triples with reifiers and annotation blocks, language tags with base direction, and the new SPARQL 1.2 functions (LANGDIR, STRLANGDIR, hasLANG, hasLANGDIR, isTRIPLE, TRIPLE, SUBJECT, PREDICATE and OBJECT).
- Updated query formatting to use @matdata/sparql-formatter, which supports SPARQL 1.2 and keeps comments in place.
Chores
- Updated the grammar generator to work with SWI-Prolog 8.3 and later.
What's Changed
- feat(yasqe): support SPARQL 1.2 syntax by @MathiasVDA in #188
- feat: format queries with @matdata/sparql-formatter (SPARQL 1.2) by @MathiasVDA in #190
- feat: endpoint describe panel (#97) by @MathiasVDA in #189
Full Changelog: v6.2.0...v6.3.0
v6.2.0
The table and graph plugin have been updated to fix several minor issues. More details on their release pages:
https://github.com/Matdata-eu/yasgui-table-plugin/releases/tag/v1.5.0
https://github.com/Matdata-eu/yasgui-graph-plugin/releases/tag/v1.6.2
Full Changelog: v6.1.1...v6.2.0
v6.1.1
Maintenance release for fixing #185: Ship ESM and CommonJS builds so packages are importable by bundlers
Full Changelog: v6.1.0...v6.1.1