@zerolith/devtools 0.1.0-alpha.4.canary.20261031.g90bacfe → 0.1.0-alpha.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -14,7 +14,13 @@ The package reads the hook the core publishes in development builds as `globalTh
14
14
 
15
15
  The guide is on the [docs site](https://molexxxx.github.io/zerolith/guide/dev-tools/).
16
16
 
17
- Status: alpha. Install with `npm install @zerolith/devtools@alpha`; the API may change before 1.0.
17
+ Status: alpha. Install with `npm install @zerolith/devtools@alpha`, at the version of `zerolith` the project uses: the two share the `zerolith/internal` entry, and `mountDevtools` stops with `package_version_mismatch` on any other version. The API may change before 1.0.
18
+
19
+ ## Documentation
20
+
21
+ - The [dev tools guide](https://molexxxx.github.io/zerolith/guide/dev-tools/) explains it with examples that run as tests.
22
+ - The [reference](https://molexxxx.github.io/zerolith/reference/zerolith-devtools/) lists every export, generated from the source.
23
+ - New to zerolith? The [tutorial](https://molexxxx.github.io/zerolith/learn/) builds an app step by step, and the [playground](https://molexxxx.github.io/zerolith/playground/) runs code in the browser.
18
24
 
19
25
  ## License
20
26
 
package/dist/index.d.ts CHANGED
@@ -5,7 +5,9 @@ export declare function describeValue(value: unknown): string;
5
5
  /**
6
6
  * Mounts the inspector dock at the bottom of the page. Returns a handle to
7
7
  * toggle or remove it. Everything the inspector creates is marked internal
8
- * so it does not appear in its own tables.
8
+ * so it does not appear in its own tables. Mounting fails with
9
+ * `package_version_mismatch` when the installed zerolith is not the version
10
+ * the inspector was released with.
9
11
  */
10
12
  export declare function mountDevtools(options?: DevtoolsOptions): DevtoolsHandle;
11
13
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8BjE,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2BpD;AA8DD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA2E3E"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8BjE,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2BpD;AA8DD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA4E3E"}
package/dist/index.js CHANGED
@@ -3,7 +3,9 @@
3
3
  * reads the hook the core publishes in development and renders a dock
4
4
  * with the reactive graph, the mounted roots, and the diagnostics feed.
5
5
  */
6
- import { computed, css, devtoolsInternal, each, html, render, signal, when } from "zerolith";
6
+ import { computed, css, each, html, render, signal, when } from "zerolith";
7
+ import { devtoolsInternal } from "zerolith/internal";
8
+ import { checkCoreVersion } from "./version.js";
7
9
  const dock = css `
8
10
  :scope { position: fixed; inset: auto 0 0 0; z-index: 2147483000; max-height: 45vh; display: grid; grid-template-rows: auto 1fr; background: #14171a; color: #e6e8eb; border-top: 1px solid #2a2f36; font: 12px/1.45 ui-monospace, monospace; }
9
11
  header { display: flex; align-items: center; gap: 4px; padding: 4px 8px; border-bottom: 1px solid #2a2f36; }
@@ -102,9 +104,12 @@ function Diagnostics(list) {
102
104
  /**
103
105
  * Mounts the inspector dock at the bottom of the page. Returns a handle to
104
106
  * toggle or remove it. Everything the inspector creates is marked internal
105
- * so it does not appear in its own tables.
107
+ * so it does not appear in its own tables. Mounting fails with
108
+ * `package_version_mismatch` when the installed zerolith is not the version
109
+ * the inspector was released with.
106
110
  */
107
111
  export function mountDevtools(options = {}) {
112
+ checkCoreVersion();
108
113
  const source = hook();
109
114
  const open = signal(options.open === true);
110
115
  const tab = signal("signals");
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** The version of this package, which the version script keeps equal to its manifest's. */
2
+ export declare const version: string;
3
+ /** Throws `package_version_mismatch` when the installed zerolith is not the inspector's own version. */
4
+ export declare function checkCoreVersion(own?: string, core?: string): void;
5
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAQA,2FAA2F;AAC3F,eAAO,MAAM,OAAO,EAAE,MAAwB,CAAC;AAE/C,wGAAwG;AACxG,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAgB,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAMtF"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * The inspector and the core share `zerolith/internal`, which can change
3
+ * with every version, so the inspector requires the zerolith it was
4
+ * released with.
5
+ */
6
+ import { DIAGNOSTIC_URL } from "zerolith";
7
+ import { version as installed } from "zerolith/internal";
8
+ /** The version of this package, which the version script keeps equal to its manifest's. */
9
+ export const version = "0.1.0-alpha.5";
10
+ /** Throws `package_version_mismatch` when the installed zerolith is not the inspector's own version. */
11
+ export function checkCoreVersion(own = version, core = installed) {
12
+ if (core !== own) {
13
+ throw new Error(`zerolith: package_version_mismatch: @zerolith/devtools ${own} requires zerolith ${own}, and zerolith ${core} is installed. Install one version of both, with npm install @zerolith/devtools@${core} or npm install zerolith@${own}. ${DIAGNOSTIC_URL}package_version_mismatch`);
14
+ }
15
+ }
16
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,OAAO,GAAW,eAAe,CAAC;AAE/C,wGAAwG;AACxG,MAAM,UAAU,gBAAgB,CAAC,GAAG,GAAW,OAAO,EAAE,IAAI,GAAW,SAAS;IAE5E,IAAI,IAAI,KAAK,GAAG,EAChB,CAAC;QACG,MAAM,IAAI,KAAK,CAAC,0DAA0D,GAAG,sBAAsB,GAAG,kBAAkB,IAAI,mFAAmF,IAAI,4BAA4B,GAAG,KAAK,cAAc,0BAA0B,CAAC,CAAC;IACrS,CAAC;AACL,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zerolith/devtools",
3
- "version": "0.1.0-alpha.4.canary.20261031.g90bacfe",
3
+ "version": "0.1.0-alpha.5",
4
4
  "description": "An in-page inspector for zerolith applications: signals, roots, and diagnostics, working wherever the app is served",
5
5
  "license": "Apache-2.0",
6
6
  "author": "molexxxx",
@@ -41,9 +41,9 @@
41
41
  "build": "tsc -p tsconfig.build.json"
42
42
  },
43
43
  "peerDependencies": {
44
- "zerolith": "^0.1.0-alpha.4.canary.20261031.g90bacfe"
44
+ "zerolith": "0.1.0-alpha.5"
45
45
  },
46
46
  "devDependencies": {
47
- "zerolith": "^0.1.0-alpha.4.canary.20261031.g90bacfe"
47
+ "zerolith": "0.1.0-alpha.5"
48
48
  }
49
49
  }
package/src/index.ts CHANGED
@@ -3,7 +3,9 @@
3
3
  * reads the hook the core publishes in development and renders a dock
4
4
  * with the reactive graph, the mounted roots, and the diagnostics feed.
5
5
  */
6
- import { type Diagnostic, type DevtoolsHook, type NodeSnapshot, type RootSnapshot, computed, css, devtoolsInternal, each, html, render, signal, when } from "zerolith";
6
+ import { type Diagnostic, computed, css, each, html, render, signal, when } from "zerolith";
7
+ import { type DevtoolsHook, type NodeSnapshot, type RootSnapshot, devtoolsInternal } from "zerolith/internal";
8
+ import { checkCoreVersion } from "./version.js";
7
9
 
8
10
  export type { DevtoolsHandle, DevtoolsOptions } from "./noop.js";
9
11
  import type { DevtoolsHandle, DevtoolsOptions } from "./noop.js";
@@ -129,10 +131,13 @@ function Diagnostics(list: () => Diagnostic[])
129
131
  /**
130
132
  * Mounts the inspector dock at the bottom of the page. Returns a handle to
131
133
  * toggle or remove it. Everything the inspector creates is marked internal
132
- * so it does not appear in its own tables.
134
+ * so it does not appear in its own tables. Mounting fails with
135
+ * `package_version_mismatch` when the installed zerolith is not the version
136
+ * the inspector was released with.
133
137
  */
134
138
  export function mountDevtools(options: DevtoolsOptions = {}): DevtoolsHandle
135
139
  {
140
+ checkCoreVersion();
136
141
  const source = hook();
137
142
  const open = signal(options.open === true);
138
143
  const tab = signal<Tab>("signals");
package/src/version.ts ADDED
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The inspector and the core share `zerolith/internal`, which can change
3
+ * with every version, so the inspector requires the zerolith it was
4
+ * released with.
5
+ */
6
+ import { DIAGNOSTIC_URL } from "zerolith";
7
+ import { version as installed } from "zerolith/internal";
8
+
9
+ /** The version of this package, which the version script keeps equal to its manifest's. */
10
+ export const version: string = "0.1.0-alpha.5";
11
+
12
+ /** Throws `package_version_mismatch` when the installed zerolith is not the inspector's own version. */
13
+ export function checkCoreVersion(own: string = version, core: string = installed): void
14
+ {
15
+ if (core !== own)
16
+ {
17
+ throw new Error(`zerolith: package_version_mismatch: @zerolith/devtools ${own} requires zerolith ${own}, and zerolith ${core} is installed. Install one version of both, with npm install @zerolith/devtools@${core} or npm install zerolith@${own}. ${DIAGNOSTIC_URL}package_version_mismatch`);
18
+ }
19
+ }