@reckona/mreact-devtools 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tatsuo Kaniwa
+
+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,29 @@
+# @reckona/mreact-devtools
+
+`@reckona/mreact-devtools` provides a small event bridge for runtime tooling.
+Reactive runtime packages can emit structured events, and developer tools can
+subscribe without coupling directly to internal runtime state.
+
+## Basic Usage
+
+```ts
+import { createDevtools, installDevtools } from "@reckona/mreact-devtools";
+
+const devtools = installDevtools(createDevtools());
+
+const unsubscribe = devtools.subscribe((event) => {
+  console.log(event.type, event.payload);
+});
+```
+
+## Core APIs
+
+- `createDevtools()` creates an isolated event bus.
+- `installDevtools()` installs a devtools instance on `globalThis`.
+- `getInstalledDevtools()` returns the currently installed instance.
+- `devtools.emit()` and `devtools.subscribe()` move runtime events.
+
+## Notes
+
+This package is intentionally small. It is the transport layer for devtools
+integrations, not a browser extension UI.

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export interface DevtoolsEvent {
+    package: string;
+    timestamp?: number;
+    type: string;
+    [key: string]: unknown;
+}
+export type DevtoolsListener = (event: DevtoolsEvent) => void;
+export interface Devtools {
+    dispose(): void;
+    emit(event: DevtoolsEvent): void;
+    events(): DevtoolsEvent[];
+    subscribe(listener: DevtoolsListener): () => void;
+}
+declare global {
+    var __mreactDevtools: Devtools | undefined;
+}
+export declare function createDevtools(): Devtools;
+export declare function installDevtools(devtools?: Devtools): Devtools;
+export declare function getInstalledDevtools(): Devtools | undefined;
+export declare function emitMreactDevtoolsEvent(packageName: string, event: {
+    type: string;
+} & Record<string, unknown>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC5C;AAED,wBAAgB,cAAc,IAAI,QAAQ,CA8BzC;AAED,wBAAgB,eAAe,CAAC,QAAQ,GAAE,QAA2B,GAAG,QAAQ,CAI/E;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,GAAG,SAAS,CAE3D;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChD,IAAI,CAMN"}

package/dist/index.js

@@ -0,0 +1,43 @@
+export function createDevtools() {
+    const recorded = [];
+    const listeners = new Set();
+    return {
+        dispose() {
+            listeners.clear();
+            recorded.length = 0;
+            if (globalThis.__mreactDevtools === this) {
+                globalThis.__mreactDevtools = undefined;
+            }
+        },
+        emit(event) {
+            recorded.push(event);
+            for (const listener of Array.from(listeners)) {
+                listener(event);
+            }
+        },
+        events() {
+            return [...recorded];
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+export function installDevtools(devtools = createDevtools()) {
+    globalThis.__mreactDevtools = devtools;
+    return devtools;
+}
+export function getInstalledDevtools() {
+    return globalThis.__mreactDevtools;
+}
+export function emitMreactDevtoolsEvent(packageName, event) {
+    globalThis.__mreactDevtools?.emit?.({
+        package: packageName,
+        timestamp: Date.now(),
+        ...event,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE9C,OAAO;QACL,OAAO;YACL,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACpB,IAAI,UAAU,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBACzC,UAAU,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK;YACR,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAErB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7C,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;QACvB,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAqB,cAAc,EAAE;IACnE,UAAU,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IAEvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,CAAC,gBAAgB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,KAAiD;IAEjD,UAAU,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;QAClC,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@reckona/mreact-devtools",
+  "version": "0.0.1",
+  "description": "Runtime event bridge for mreact developer tooling.",
+  "keywords": [
+    "debugging",
+    "devtools",
+    "events",
+    "jsx",
+    "mreact",
+    "typescript"
+  ],
+  "homepage": "https://github.com/t-k/mreact/tree/main/packages/devtools#readme",
+  "bugs": {
+    "url": "https://github.com/t-k/mreact/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t-k/mreact.git",
+    "directory": "packages/devtools"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}