@vobs/devtools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vobs contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @vobs/devtools
+
+Debug instrumentation for Vobs applications: owner trees, signals, effects, dependency graphs, update traces, DOM mutations, network requests and errors.
+
+## Install
+
+```bash
+npm install @vobs/devtools
+```
+
+## Quick start
+
+```ts
+import { devtoolsPlugin, getDevTools } from '@vobs/devtools'
+import { createVobs } from '@vobs/vobs'
+
+createVobs({ render, plugins: [devtoolsPlugin({ maxUpdates: 200 })] })
+
+const devtools = getDevTools()
+devtools?.subscribe('update', trace => {
+  console.log(trace.signalName, trace.duration, trace.domUpdates.length)
+})
+```
+
+## API
+
+| Signature | Description |
+| --- | --- |
+| `createDevTools(options?)` | Start collecting debug data through the reactivity, runtime and HTTP debug hooks; returns a `DevToolsAPI`. Options include `expose`, `target`, `maxUpdates`, `slowUpdateThreshold`, `privacy`, `allowMutations` and `router`. |
+| `enableDevTools(options?)` / `disableDevTools()` | Create or dispose the global instance. |
+| `getDevTools()` | Read the active `DevToolsAPI`, or `null`. |
+| `devtoolsPlugin(options?)` | Wrap collection in a `VobsPlugin` that also reports application errors; set `enabled: false` to skip. |
+| `connectDevTools(options?)` | Expose the API to a panel over `postMessage` (request/response/event protocol); returns a disconnect function. |
+| `api.getComponentTree()` / `api.getComponent(ownerId)` | Owner tree with per-component signals, effects, recent updates and DOM mutation counts. |
+| `api.getSignals()` / `api.getSignal(id)` | Signal and memo values, owners and subscriber counts. |
+| `api.getEffects()` | Effect status, execution count, last duration and last error. |
+| `api.getDependencies(id)` / `api.getDependents(id)` | Dependency graph edges (`state-to-memo`, `memo-to-effect`, ...). |
+| `api.getUpdates()` / `api.onUpdate(callback)` | One trace per update: previous/next values, affected effects, DOM updates, status and duration. |
+| `api.getNetworkRequests()` | HTTP request traces with timing, retries, route and environment. |
+| `api.getErrors()` / `api.reportError(phase, error, context?)` | Error traces grouped by phase and origin. |
+| `api.subscribe(event, callback)` | Listen to `DEVTOOLS_EVENTS` such as `signal-update`, `effect-run`, `dom-update`, `network-request` or `error`; returns an unsubscribe function. |
+| `api.setSignalValue(id, value)` | Mutate a signal; requires `allowMutations: true`. |
+| `api.setCollectionPaused(paused)` / `api.clearUpdates()` / `api.clearNetworkRequests()` / `api.clearErrors()` / `api.clearLifecycleEvents()` | Collection control. |
+| `api.getPerformanceMetrics()` / `api.takeMemorySnapshot()` | Update/effect/request timing aggregates and signal/effect/owner counts. |
+| `api.exportDiagnostics()` / `api.importDiagnostics(snapshot)` | Export or restore a full `DevToolsDiagnosticSnapshot`. |
+| `api.registerInspector(id, inspector)` / `api.registerTimeline(id, timeline?)` / `api.registerMetric(id, metric)` | Extension points surfaced through `getExtensionSnapshot()`. |
+
+## Types
+
+DevToolsAPI, DevToolsOptions, DevToolsPluginOptions, DevToolsBridgeOptions, DevToolsTarget, DevToolsRouterSource, DevToolsRouterContext, ComponentDebugNode, SignalDebugInfo, EffectDebugInfo, DependencyEdge, DependencyEdgeType, UpdateTrace, EffectExecutionInfo, DomUpdateInfo, LifecycleEvent, LifecycleEventType, NetworkRequestTrace, DebugErrorInfo, DevToolsErrorTrace, DevToolsErrorPhase, DevToolsErrorOrigin, DevToolsErrorRecovery, DevToolsErrorContext, DevToolsCollectionState, DevToolsPrivacyOptions, DevToolsPerformanceEntry, PerformanceMetrics, MemorySnapshot, DevToolsDiagnosticSnapshot, DevToolsExtensionSnapshot, DevToolsInspector, DevToolsTimeline, DevToolsTimelineEvent, DevToolsMetric, DevToolsSelection, DevToolsSSRRequestSnapshot, DevToolsWireRequest, DevToolsWireResponse, DevToolsWireEvent, DevToolsMessageTarget, DevToolsMessageEvent

package/package.json

@@ -0,0 +1,22 @@
+{
+  "license": "MIT",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "name": "@vobs/devtools",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@vobs/reactivity": "1.0.0",
+    "@vobs/runtime": "1.0.0",
+    "@vobs/http": "1.0.0",
+    "@vobs/vobs": "1.0.0"
+  }
+}