Governed HyperPBI 2.0 authoring

Build, inspect, and evolve complete dashboard experiences inside one Power BI visual.

Combine AI-assisted JSON generation, reusable logical datasets, controlled interactions, declarative SVG, Leaflet and ArcGIS maps, and stable targeted changes—without turning dashboard content into executable code.

Explore the Visual InspectorBrowse 84 componentsRead the user guide
1Describe the dashboardGenerate AI-ready prompts from reviewed field metadata.
2Validate & PreviewStrict schema, references, security, and calculation diagnostics.
3Inspect the hierarchyClick rendered nodes and edit their stable authoring owner.
4Apply targeted changesPreview a strict change package before explicit apply.
2.0authoring schema version
84canonical component types
12implementation categories
1.0.0.0PBIVIZ package version
Human-controlled workflow

AI can propose. HyperPBI still decides what is valid.

HyperPBI composes local prompts and never calls an AI API. The user copies reviewed context to an approved service, pastes one response, and explicitly controls preview and apply.

Bind fields

Build a privacy-aware Field Manifest from the current visual query.

Generate or edit JSON

Author directly or copy a governed AI prompt.

Validate and preview

Prepare the complete candidate without replacing valid state.

Inspect the hierarchy

Locate rendered content by canonical authoring path.

Apply targeted changes

Review the mutation summary, then apply explicitly.

Save and interact

Preserve stable IDs, Power BI selection, and filter safeguards.

Permanent Visual Inspector

Work with the dashboard structure, not a scavenger hunt through JSON.

Inspect preview mode maps a clicked runtime component to its editable authoring owner. Candidate edits are prepared and validated before the preview changes; an invalid edit keeps the last valid dashboard intact.

UndoRedoInspect preview: on
matrix · regional_performanceValidation passed
Stable IDregional_performance
Effective datasetregionalSummary
Canonical JSON path/components/0/children/2
Generated ownershipAuthoring node
DataField selector
actual — Actual · number
AppearanceHeatmap
Per-metric scale
InteractionPower BI behavior
Selection · source identity
AdvancedStructured JSON
Validated local draft
Add childInsert beforeInsert afterMoveDuplicateDelete

The real Inspector uses a resizable two-pane desktop layout and an accessible Tree / Properties switch at narrow Power BI visual sizes. Stable IDs support targeted AI replacement while unrelated nodes remain unchanged.

Declarative SVG

Data-bound process visuals without user JavaScript.

Build KPI illustrations, process flows, pumps and equipment, and infrastructure diagrams from allowlisted SVG elements.

  • Literal, field, template, conditional, state, and bounded repeat bindings
  • Sanitized svgMarkup escape hatch when structured SVG is insufficient
  • Animation presets, reduced-motion support, and normal HyperPBI interactions
  • Local ID isolation for gradients, clips, masks, and markers
  • No scripts, event attributes, foreignObject, images, or external SVG resources
Water process equipment illustrationA safe decorative pump, pipeline, flow markers, and KPI gauge.Pump station efficiency94%
Map Studio layers
Facilities · activeFacilities128
ArcGIS districts · service12
Incidents · recentIncidents47
Layer tree · live preview · properties · diagnostics
Declarative analytical Web GIS

Map Studio builds independent, dataset-aware layers.

Put every Power BI field in the single Values well, then configure each layer's dataset and source bindings in canonical JSON. Logical datasets create different layer views over the one flattened data view received from Power BI.

  • Layer tree, live preview, and properties for source, dataset binding, symbology, labels, popup, joins, and diagnostics
  • Power BI and public ArcGIS feature, tile, and dynamic layers with independent fields and lineage
  • Layer groups, view bookmarks, structured filters, safe popup actions, and bounded performance controls
  • Structured coordinate, mixed-geometry, request, join, truncation, and timing diagnostics
  • Strict schema/runtime capability registry marks partial and experimental behavior honestly
  • Core has no WebAccess; Maps adds intended host privileges with the same Values-only role contract
  • Geocoder behavior is unchanged: default none, explicitly configured, user-triggered, and policy-gated

HyperPBI is an analytical Web GIS builder for Power BI—not a feature-editing or 3D GIS replacement.

Canonical component descriptors

84 component types across 12 generated categories.

The inventory, maturity, Inspector controls, strict properties, field handlers, documentation, AI reference, and valid examples are generated from canonical component descriptors.

LayoutGrid, flex, sections, toolbars, panels
ControlsSearch, selectors, dates, inputs
NavigationTabs, accordion, steps, overlays
DisplayKPIs, metrics, status, details
ChartsSemantic ECharts adapters
TablesDetail table and multi-value matrix
MapsPower BI data and ArcGIS services
CustomText, Markdown, sanitized HTML, SVG
Search the generated catalog
Security boundaries

Advanced presentation without an executable-content sandbox.

Every advanced surface has a parser, allowlist, scope, and limit. Dashboard JSON never gains unrestricted code execution or provider access.

JS

No user JavaScript

No eval, functions, callbacks, inline handlers, SQL, or network datasets.

H

Sanitized HTML and CSS

DOMPurify plus parsed, allowlisted, selector-scoped CSS and URL policy.

V

SVG isolation

Allowlisted elements and references, namespaced IDs, and exact rendering budgets.

P

Prompt privacy

Fields, samples, masked, summary, or types modes remain local until copied.

I

Interaction safeguards

External filters require a real Power BI model-column target.

W

Provider policy

Independent tile, geocoder, and ArcGIS service authorization with normalized errors.

Distribution profiles

Choose external service privilege explicitly.

Both packages expose the same Power BI data-role contract. Their difference is WebAccess and provider availability—not authored schema behavior.

Core No WebAccess

All non-network dashboard features and bound Power BI map data.

npm run package:core

Maps Optional WebAccess

Configured HTTPS tiles, geocoders, and ArcGIS services subject to host policy.

npm run package:maps

HyperPBI schema version 2.0 is an authoring contract. PBIVIZ package version 1.0.0.0 is the Power BI artifact version; they evolve independently.

Documentation

Implementation, human guidance, and AI guidance stay aligned.

Generated references are checked against canonical descriptors and checked-in source guidance.

User guideStudio, Inspector, preview, and save workflowSpecification referenceStrict schema, datasets, components, and maturityAI authoringStrict change packages and preview-before-applySVG visualsBindings, repeats, motion, limits, and securityMap servicesRoles, diagnostics, providers, and package profilesSecuritySanitizers, interactions, URLs, and provider boundariesInteractionsInternal state, identity selection, and filtersRepair workflowStructured diagnostics and preservationContributor READMEArchitecture, commands, and maintenance