@plitzi/sdk-dev-tools 0.38.7 → 0.38.9

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # @plitzi/sdk-dev-tools
 
+## 0.38.9
+
+### Patch Changes
+
+- 64f4cd6: - **`unusedPort()`** (`@plitzi/sdk-server`): a port the system has just handed out, for a test to listen on. The
+  package's own tests and `@plitzi/sdk-mcp`'s listened on fixed ports in the ephemeral range (393xx), which any
+  outgoing connection of a test running beside them could take: CI failed with `EADDRINUSE` on runs with nothing
+  wrong. Every one now listens on a port the system gives it.
+  - **Brotli at quality 5** (`@plitzi/sdk-server`): `compression.brotliQuality`, for a page rendered for one request, is
+    5 (was 2). At 2 a 220 KB page came out larger than gzip — 36 KB against 31 — and at 5 it is 29 KB, for the CPU gzip
+    spends; on half a core ~0.1 ms a page.
+  - **`verify` checks the pages for signed-in visitors** (`@plitzi/cli`): a page that sends the browser to sign in is
+    checked again signed in as the account `.env` names — `PLITZI_CHECK_USER`, `PLITZI_CHECK_PASSWORD` (the environment
+    wins over `.env`). With none named, `verify` says how. `page check --as` reads the password from `.env` too, and
+    `page check` takes several pages, in one browser.
+  - **An address that shows nothing answers 404** (`@plitzi/sdk-shared`, `@plitzi/plitzi-sdk`, `@plitzi/sdk-server`):
+    one no page answers was sent to the home page with a 302 — every typo read as the home page. A page whose slug is
+    `'*'` is now the space's page for it, sent with status 404 (a folder may have its own; the deepest wins), and a page
+    gated off by a flag shows it too. Never kept in the page cache: an address asked for at random filled it. Only a slug
+    that IS `'*'`: a page answering a subtree by its own (`spaces/:spaceId/update/*`) stays a page like any other.
+  - **`authorSpace` gives a space with no `'*'` page a plain one** (`@plitzi/sdk-authoring`), in the home page's layout,
+    and says so: suggestion `not-found-page`. The project templates carry their own.
+  - **`notFound` on a server provider** (`@plitzi/sdk-elements`, `@plitzi/sdk-server`): an expression against its answer
+    (`{{ source.found == false }}`); when it is true the page is sent with status 404, rendered as written. Refused on a
+    browser provider (`not-found-in-browser`) and when it is not one expression (`not-found-not-a-template`).
+  - **`page check` and `verify` know a page sent with 404** (`@plitzi/cli`): it is said, not failed; the space's `'*'`
+    page is checked at an address no page has, and fails if it is not sent with 404.
+  - **A form field draws no background of its own** (`@plitzi/sdk-elements`): the `<input>` inside a form control's box
+    (`field`) took `background-color: inherit`, and painted a translucent box colour a second time — a darker box inside
+    the padding (Tremor's search). It is `transparent`: the box shows through it.
+  - **`space lint` offers `quiet` only where there is an element to put it on** (`@plitzi/cli`): a suggestion about what
+    the space lacks — `not-found-page` — is answered by writing it.
+  - **`feedback --previous`** (`@plitzi/cli`): the brief says what to do when an earlier report's link no longer opens —
+    say so, and ask the person for the highest id it had.
+  - **`start:prod` runs in production by itself** (`@plitzi/cli`): `NODE_ENV=production node …`. Without the variable a
+    deployed project was a development server — dev tools on, and every public action answering its `steps` and `trace`
+    (each step's result, what the `output` was meant to leave out). `doctor` says a `start:prod` that does not
+    (`start-prod-not-production`); `plitzi upgrade --write` rewrites the script.
+  - **A project's `ActionRefusal` reaches the flow** (`@plitzi/sdk-server`): a functions bundle carries its own copy of the
+    class, so `instanceof` never knew it and the run lost its reason (`{{ x.error }}` empty). Told apart by name now.
+  - **Plugins are not remounted after hydration** (`@plitzi/sdk-elements`): the registry wrapped each plugin again when
+    the host handed it over again, a new component type every time — the server's HTML thrown away, entrances replayed,
+    effects run twice. Each plugin component is wrapped once.
+  - **`start:dev` survives a space that does not author** (`@plitzi/sdk-server`): a restart while the space had an error
+    died, and fixing the space woke nothing. It comes up answering every page with what is wrong (503), and loads the
+    space the first time a save authors.
+  - **`page check` sees what is cut off at the screen's edge** (`@plitzi/sdk-authoring`, `@plitzi/cli`): a link or words an
+    ancestor hides past the viewport, which no sideways scroll shows (`cut-off`).
+  - **`page shot --click <element...> --sheet`** (`@plitzi/cli`): elements clicked in order — a name or a CSS selector,
+    inside a plugin too — pictured after each (`--frames`/`--every`), with how much changed, and every picture on one
+    contact sheet. The dev tools' badge is no longer in a picture: its shadow root is marked (`@plitzi/sdk-dev-tools`).
+  - **`formControl` is optional unless it says `required: true`** (`@plitzi/sdk-elements`), as an HTML field is. A field
+    left without `required` in an older space was required, and is not now.
+  - **`text({ decorative })`, `list({ label })`** (`@plitzi/sdk-elements`); **`writing-mode`, `text-orientation`** in the
+    CSS vocabulary (`@plitzi/sdk-shared`).
+  - **`unused-token` reads the plugins' stylesheets** (`@plitzi/sdk-authoring`): `authorSpace`'s `stylesheets`, which
+    `projectAuthoring` fills with every `.css` under `src/plugins/` — a token only a plugin used was said to be unused.
+  - **`id-taken` on a provider placed on two pages points at the layout they share** (`@plitzi/sdk-authoring`), not at
+    `scope()`, which renamed its source and every template reading it.
+  - **The welcome template's tokens keep their names** (`@plitzi/sdk-authoring`): `satisfies`, not an annotation, so
+    `tokens(variables).card` typechecks as the cheatsheet teaches.
+- Updated dependencies [64f4cd6]
+  - @plitzi/sdk-shared@0.38.9
+  - @plitzi/sdk-plugins@0.38.9
+  - @plitzi/sdk-schema@0.38.9
+
+## 0.38.8
+
+### Patch Changes
+
+- Updated dependencies [1b45aae]
+  - @plitzi/sdk-schema@0.38.8
+  - @plitzi/sdk-shared@0.38.8
+  - @plitzi/sdk-plugins@0.38.8
+
 ## 0.38.7
 
 ### Patch Changes

package/dist/DevToolsContainer.mjs

@@ -10,70 +10,75 @@ import c from "@plitzi/plitzi-ui/hooks/useStorage";
 import l from "clsx";
 import { Suspense as u, lazy as d, useCallback as f, useRef as p, useState as m } from "react";
 import { DevStoreScopeContext as h } from "@plitzi/nexus/react";
-import g from "@plitzi/sdk-shared/theme/useTheme";
-import { jsx as _, jsxs as v } from "react/jsx-runtime";
+import { DEV_TOOLS_ATTRIBUTE as g } from "@plitzi/sdk-shared/devTools/chrome";
+import _ from "@plitzi/sdk-shared/theme/useTheme";
+import { jsx as v, jsxs as y } from "react/jsx-runtime";
 //#region src/DevToolsContainer.tsx
-var y = d(() => import("./components/DevToolsOverlay/index.mjs")), b = "horizontal", x = 0, S = ({ children: d, className: S, innerClassName: C, enabled: w = !1, instanceId: T, renderMode: E = "default", scroll: D = "container", qa: O = !1, devToolsStyle: k = "", devToolsStyleLink: A = "", devToolsIconsLink: j = "" }) => {
-	let { resolvedTheme: M } = g(), [N, P] = c("plitzi-sdk.dev-tools.orientation", b), [F, I] = c("plitzi-sdk.dev-tools.collapsed", !0), [L, R] = c("plitzi-sdk.dev-tools.tab", "logs"), [z, B] = m(), V = p(void 0), H = p(null);
-	V.current ||= `sdk-instance-${++x}`;
-	let U = T || V.current, W = i(), G = W ? N : b, K = r(U, w);
-	o(w), a(K, U), e(K);
-	let q = f((e) => P(e), [P]), J = f((e) => {
-		e && R("logs"), B(e), I(!1);
-	}, [I, R]), Y = f(() => I(!0), [I]), X = f((e) => {
-		B(void 0), R(e);
-	}, [R]);
-	if (!w) return d;
-	let Z = D === "document" && (!W || F), Q = K && W && /* @__PURE__ */ _(n, { children: /* @__PURE__ */ _(t, { children: /* @__PURE__ */ v(u, {
+var b = d(() => import("./components/DevToolsOverlay/index.mjs")), x = "horizontal", S = 0, C = ({ children: d, className: C, innerClassName: w, enabled: T = !1, instanceId: E, renderMode: D = "default", scroll: O = "container", qa: k = !1, devToolsStyle: A = "", devToolsStyleLink: j = "", devToolsIconsLink: M = "" }) => {
+	let { resolvedTheme: N } = _(), [P, F] = c("plitzi-sdk.dev-tools.orientation", x), [I, L] = c("plitzi-sdk.dev-tools.collapsed", !0), [R, z] = c("plitzi-sdk.dev-tools.tab", "logs"), [B, V] = m(), H = p(void 0), U = p(null);
+	H.current ||= `sdk-instance-${++S}`;
+	let W = E || H.current, G = i(), K = G ? P : x, q = r(W, T);
+	o(T), a(q, W), e(q);
+	let J = f((e) => F(e), [F]), Y = f((e) => {
+		e && z("logs"), V(e), L(!1);
+	}, [L, z]), X = f(() => L(!0), [L]), Z = f((e) => {
+		V(void 0), z(e);
+	}, [z]);
+	if (!T) return d;
+	let Q = O === "document" && (!G || I), $ = q && G && /* @__PURE__ */ v(n, { children: /* @__PURE__ */ v(t, { children: /* @__PURE__ */ y(u, {
 		fallback: null,
-		children: [E === "default" && /* @__PURE__ */ _(y, {
-			className: l({ dark: M === "dark" }),
-			collapsed: F,
-			orientation: G,
-			tabSelected: L,
-			logTypeFilter: z,
-			onOpen: J,
-			onCollapse: Y,
-			onTabSelect: X,
-			onChangeOrientation: q,
-			pageRef: H,
-			qa: O
-		}), E === "shadow" && /* @__PURE__ */ v(s, { children: [
-			j && /* @__PURE__ */ _(s.Link, { href: j }),
-			A && /* @__PURE__ */ _(s.Link, { href: A }),
-			/* @__PURE__ */ v(s.Content, { children: [/* @__PURE__ */ _("style", { dangerouslySetInnerHTML: { __html: k } }), /* @__PURE__ */ _(y, {
-				className: l({ dark: M === "dark" }),
-				collapsed: F,
-				orientation: G,
-				tabSelected: L,
-				logTypeFilter: z,
-				onOpen: J,
-				onCollapse: Y,
-				onTabSelect: X,
-				onChangeOrientation: q,
-				pageRef: H,
-				qa: O
-			})] })
-		] })]
+		children: [D === "default" && /* @__PURE__ */ v(b, {
+			className: l({ dark: N === "dark" }),
+			collapsed: I,
+			orientation: K,
+			tabSelected: R,
+			logTypeFilter: B,
+			onOpen: Y,
+			onCollapse: X,
+			onTabSelect: Z,
+			onChangeOrientation: J,
+			pageRef: U,
+			qa: k
+		}), D === "shadow" && /* @__PURE__ */ v("div", {
+			style: { display: "contents" },
+			[g]: "",
+			children: /* @__PURE__ */ y(s, { children: [
+				M && /* @__PURE__ */ v(s.Link, { href: M }),
+				j && /* @__PURE__ */ v(s.Link, { href: j }),
+				/* @__PURE__ */ y(s.Content, { children: [/* @__PURE__ */ v("style", { dangerouslySetInnerHTML: { __html: A } }), /* @__PURE__ */ v(b, {
+					className: l({ dark: N === "dark" }),
+					collapsed: I,
+					orientation: K,
+					tabSelected: R,
+					logTypeFilter: B,
+					onOpen: Y,
+					onCollapse: X,
+					onTabSelect: Z,
+					onChangeOrientation: J,
+					pageRef: U,
+					qa: k
+				})] })
+			] })
+		})]
 	}) }) });
-	return /* @__PURE__ */ v("div", {
+	return /* @__PURE__ */ y("div", {
 		className: l("relative flex min-w-0 grow", {
-			"overflow-auto": !Z,
-			"flex-col": Z || G === "horizontal",
-			"h-screen": !Z && G === "vertical"
-		}, S),
-		children: [/* @__PURE__ */ _(h, {
-			value: U,
-			children: /* @__PURE__ */ _("div", {
-				ref: H,
-				className: l("grow", { "basis-0 flex-col overflow-auto": !Z }, C),
+			"overflow-auto": !Q,
+			"flex-col": Q || K === "horizontal",
+			"h-screen": !Q && K === "vertical"
+		}, C),
+		children: [/* @__PURE__ */ v(h, {
+			value: W,
+			children: /* @__PURE__ */ v("div", {
+				ref: U,
+				className: l("grow", { "basis-0 flex-col overflow-auto": !Q }, w),
 				children: d
 			})
-		}), Z ? /* @__PURE__ */ _("div", {
+		}), Q ? /* @__PURE__ */ v("div", {
 			className: "sticky bottom-0 h-0",
-			children: Q
-		}) : Q]
+			children: $
+		}) : $]
 	});
 };
 //#endregion
-export { S as default };
+export { C as default };

package/dist/agentInspector/report.d.ts

@@ -1,4 +1,4 @@
-/** An element as it is asked about — by the panel, by `window.__plitzi.element()` and through it `plitzi check`. */
+/** An element as it is asked about — by the panel, by `window.__plitzi.element()` and through it `plitzi page check`. */
 export type ElementReport = {
     id: string;
     type?: string;

package/dist/components/DevToolsIndicator/DevToolsIndicator.mjs

@@ -1,11 +1,11 @@
 import e from "clsx";
 import { use as t, useCallback as n, useMemo as r } from "react";
-import i from "@plitzi/sdk-shared/devTools/DevToolsContext";
-import { jsx as a, jsxs as o } from "react/jsx-runtime";
-import { DEV_TOOLS_ATTRIBUTE as s } from "@plitzi/sdk-shared/devTools/chrome";
+import { DEV_TOOLS_ATTRIBUTE as i } from "@plitzi/sdk-shared/devTools/chrome";
+import a from "@plitzi/sdk-shared/devTools/DevToolsContext";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
 //#region src/components/DevToolsIndicator/DevToolsIndicator.tsx
 var c = ({ className: c, onOpen: l }) => {
-	let { logs: u } = t(i), { errors: d, warnings: f } = r(() => u.reduce((e, { logType: t }) => ({
+	let { logs: u } = t(a), { errors: d, warnings: f } = r(() => u.reduce((e, { logType: t }) => ({
 		errors: t === "danger" ? e.errors + 1 : e.errors,
 		warnings: t === "warning" ? e.warnings + 1 : e.warnings
 	}), {
@@ -26,24 +26,24 @@ var c = ({ className: c, onOpen: l }) => {
 		f,
 		l
 	]);
-	return /* @__PURE__ */ a("div", {
+	return /* @__PURE__ */ o("div", {
 		className: e("absolute bottom-3 left-3 z-[1000000]", c),
-		[s]: "",
-		children: /* @__PURE__ */ o("button", {
+		[i]: "",
+		children: /* @__PURE__ */ s("button", {
 			className: e("flex cursor-pointer items-center gap-2 rounded border border-zinc-200 bg-white px-2 py-1.5 text-[12px]/[16px]", "font-bold text-zinc-600 shadow-md transition-colors select-none hover:bg-zinc-50", "dark:border-zinc-700 dark:bg-zinc-900 dark:text-zinc-300 dark:hover:bg-zinc-800"),
 			title: "Plitzi dev tools",
 			onClick: p,
 			children: [
 				"Plitzi",
-				d > 0 && /* @__PURE__ */ o("span", {
+				d > 0 && /* @__PURE__ */ s("span", {
 					className: "flex items-center gap-1 text-red-600 dark:text-red-400",
-					children: [/* @__PURE__ */ a("i", { className: "fa-regular fa-circle-xmark text-[11px]" }), d]
+					children: [/* @__PURE__ */ o("i", { className: "fa-regular fa-circle-xmark text-[11px]" }), d]
 				}),
-				f > 0 && /* @__PURE__ */ o("span", {
+				f > 0 && /* @__PURE__ */ s("span", {
 					className: "flex items-center gap-1 text-amber-600 dark:text-amber-400",
-					children: [/* @__PURE__ */ a("i", { className: "fa-solid fa-triangle-exclamation text-[11px]" }), f]
+					children: [/* @__PURE__ */ o("i", { className: "fa-solid fa-triangle-exclamation text-[11px]" }), f]
 				}),
-				d === 0 && f === 0 && /* @__PURE__ */ a("i", { className: "fa-solid fa-terminal text-[11px] text-zinc-400" })
+				d === 0 && f === 0 && /* @__PURE__ */ o("i", { className: "fa-solid fa-terminal text-[11px] text-zinc-400" })
 			]
 		})
 	});

package/dist/components/DevToolsPanel/DevToolsPanel.mjs

@@ -4,20 +4,20 @@ import n from "./DevToolsSubHeader.mjs";
 import r from "@plitzi/plitzi-ui/hooks/useStorage";
 import i from "clsx";
 import { useCallback as a, useMemo as o, useRef as s, useState as c } from "react";
-import { useCommonStore as l } from "@plitzi/sdk-shared/store";
-import { jsx as u, jsxs as d } from "react/jsx-runtime";
-import { DEV_TOOLS_ATTRIBUTE as f } from "@plitzi/sdk-shared/devTools/chrome";
+import { DEV_TOOLS_ATTRIBUTE as l } from "@plitzi/sdk-shared/devTools/chrome";
+import { useCommonStore as u } from "@plitzi/sdk-shared/store";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
 import p from "@plitzi/plitzi-ui/ContainerResizable";
 //#region src/components/DevToolsPanel/DevToolsPanel.tsx
 var m = "vertical", h = "horizontal", g = ({ className: m, orientation: h = "vertical", tabSelected: g, logTypeFilter: _, onCollapse: v, onTabSelect: y, onChangeOrientation: b, qa: x = !1 }) => {
 	let [S, C] = r("plitzi-sdk.dev-tools.size", {
 		width: 500,
 		height: 200
-	}), [w] = l("navigation.currentPageId"), [T, E] = c(), D = o(() => h === "vertical" ? ["w"] : ["n"], [h]), O = s(typeof document < "u" ? document.querySelector(".plitzi-sdk") : null), k = a((e) => E(e), [E]), A = a((e, t) => C((n) => ({
+	}), [w] = u("navigation.currentPageId"), [T, E] = c(), D = o(() => h === "vertical" ? ["w"] : ["n"], [h]), O = s(typeof document < "u" ? document.querySelector(".plitzi-sdk") : null), k = a((e) => E(e), [E]), A = a((e, t) => C((n) => ({
 		width: Number.isFinite(e) ? e : n.width,
 		height: Number.isFinite(t) ? t : n.height
 	})), [C]);
-	return /* @__PURE__ */ u(p, {
+	return /* @__PURE__ */ d(p, {
 		className: i("component__container-resizable-sidebar relative z-[1000000] text-xs", m, { "h-full": h === "vertical" }),
 		minConstraintsX: h === "vertical" ? 500 : Infinity,
 		maxConstraintsX: h === "vertical" ? 1e3 : Infinity,
@@ -29,11 +29,11 @@ var m = "vertical", h = "horizontal", g = ({ className: m, orientation: h = "ver
 		parentRef: O,
 		autoGrow: !1,
 		onChange: A,
-		children: /* @__PURE__ */ d("div", {
+		children: /* @__PURE__ */ f("div", {
 			className: "flex h-full w-full flex-col bg-white text-zinc-800 dark:bg-zinc-900 dark:text-zinc-200",
-			[f]: "",
+			[l]: "",
 			children: [
-				/* @__PURE__ */ u(t, {
+				/* @__PURE__ */ d(t, {
 					orientation: h,
 					onChangeOrientation: b,
 					onCollapse: v,
@@ -41,12 +41,12 @@ var m = "vertical", h = "horizontal", g = ({ className: m, orientation: h = "ver
 					tabSelected: g,
 					qa: x
 				}),
-				["store", "elements"].includes(g) && /* @__PURE__ */ u(n, {
+				["store", "elements"].includes(g) && /* @__PURE__ */ d(n, {
 					elementSelected: T,
 					onSelectElement: k,
 					currentPageId: w
 				}),
-				/* @__PURE__ */ u(e, {
+				/* @__PURE__ */ d(e, {
 					orientation: h,
 					tabSelected: g,
 					logTypeFilter: _,

package/dist/components/DevToolsPanel/tabs/ElementsViewer/components/DetailsRuntime/DetailsRuntime.d.ts

@@ -2,7 +2,7 @@ export type DetailsRuntimeProps = {
     id: string;
 };
 /**
- * The element as the page has it now — the same report `window.__plitzi.element()` and `plitzi check --element` give:
+ * The element as the page has it now — the same report `window.__plitzi.element()` and `plitzi page check --element` give:
  * its own state, what it binds to, how many copies are on the page and where. Read again every second.
  */
 declare const DetailsRuntime: ({ id }: DetailsRuntimeProps) => import('react').JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-dev-tools",
-  "version": "0.38.7",
+  "version": "0.38.9",
   "license": "AGPL-3.0",
   "files": [
     "dist"
@@ -1211,9 +1211,9 @@
   "dependencies": {
     "@plitzi/nexus": "^1.4.0",
     "@plitzi/plitzi-ui": "^1.6.32",
-    "@plitzi/sdk-plugins": "0.38.7",
-    "@plitzi/sdk-schema": "0.38.7",
-    "@plitzi/sdk-shared": "0.38.7",
+    "@plitzi/sdk-plugins": "0.38.9",
+    "@plitzi/sdk-schema": "0.38.9",
+    "@plitzi/sdk-shared": "0.38.9",
     "@uiw/react-json-view": "^2.0.0-alpha.43",
     "clsx": "^2.1.1"
   }