@plitzi/sdk-elements 0.38.8 → 0.38.9

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # @plitzi/sdk-elements
 
+## 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-navigation@0.38.9
+  - @plitzi/sdk-auth@0.38.9
+  - @plitzi/sdk-event-bridge@0.38.9
+  - @plitzi/sdk-interactions@0.38.9
+  - @plitzi/sdk-schema@0.38.9
+
 ## 0.38.8
 
 ### Patch Changes

package/dist/Component/ComponentHelper.mjs

@@ -3,8 +3,8 @@ import t from "../Element/hocs/withElement.mjs";
 //#region src/Component/ComponentHelper.ts
 var n = /* @__PURE__ */ e({
 	getPlugins: () => r,
-	nestedInject: () => a,
-	processLocalCustomPlugins: () => o,
+	nestedInject: () => s,
+	processLocalCustomPlugins: () => c,
 	processLocalPlugins: () => i
 }), r = (e) => {
 	let t = {};
@@ -19,20 +19,29 @@ var n = /* @__PURE__ */ e({
 	return e && Object.values(e).forEach((e) => {
 		e.type && Object.assign(t, r(e));
 	}), t;
-}, a = (e, n) => {
+}, a = {
+	local: /* @__PURE__ */ new WeakMap(),
+	"local-custom": /* @__PURE__ */ new WeakMap(),
+	remote: /* @__PURE__ */ new WeakMap()
+}, o = (e, n) => {
+	let r = a[n].get(e);
+	if (r) return r;
+	let i = t(e);
+	return a[n].set(e, i), i;
+}, s = (e, t) => {
 	if (!e) return {};
-	let r = {};
-	return Object.keys(e).forEach((i) => {
-		let o = e[i], { version: s, pluginSettings: c, initialItems: l, plugins: u, extraProps: d } = o;
-		r[i] = t(o), r[i].origin = n, r[i].version = s, r[i].type = i, r[i].initialItems = l, r[i].pluginSettings = c, r[i].extraProps = d, r[i].plugins = a(u, n);
-	}), r;
-}, o = (e) => {
 	let n = {};
+	return Object.keys(e).forEach((r) => {
+		let i = e[r], { version: a, pluginSettings: c, initialItems: l, plugins: u, extraProps: d } = i;
+		n[r] = o(i, t), n[r].origin = t, n[r].version = a, n[r].type = r, n[r].initialItems = l, n[r].pluginSettings = c, n[r].extraProps = d, n[r].plugins = s(u, t);
+	}), n;
+}, c = (e) => {
+	let t = {};
 	return e && Object.values(e).forEach((e) => {
 		if (!e.type) return;
-		let { type: i, pluginSettings: o, version: s, initialItems: c, plugins: l, assets: u, content: d, extraProps: f } = e, p = t(e);
-		p.version = s, p.type = i, p.assets = u, p.initialItems = c, p.pluginSettings = o, p.origin = "local-custom", p.content = d, p.extraProps = f, p.plugins = a(l, "local-custom"), Object.assign(n, r(p));
-	}), n;
+		let { type: n, pluginSettings: i, version: a, initialItems: c, plugins: l, assets: u, content: d, extraProps: f } = e, p = o(e, "local-custom");
+		p.version = a, p.type = n, p.assets = u, p.initialItems = c, p.pluginSettings = i, p.origin = "local-custom", p.content = d, p.extraProps = f, p.plugins = s(l, "local-custom"), Object.assign(t, r(p));
+	}), t;
 };
 //#endregion
-export { n as ComponentHelper_exports, r as getPlugins, a as nestedInject, o as processLocalCustomPlugins, i as processLocalPlugins };
+export { n as ComponentHelper_exports, r as getPlugins, s as nestedInject, c as processLocalCustomPlugins, i as processLocalPlugins };

package/dist/elements/basic/Text/Settings.d.ts

@@ -1,6 +1,7 @@
 type SettingsProps = {
     content?: string;
+    decorative?: boolean;
     onUpdate?: (key: string, value: string | boolean | number) => void;
 };
-declare const Settings: ({ content, onUpdate }: SettingsProps) => import('react').JSX.Element;
+declare const Settings: ({ content, decorative, onUpdate }: SettingsProps) => import('react').JSX.Element;
 export default Settings;

package/dist/elements/basic/Text/Settings.mjs

@@ -1,19 +1,25 @@
 import { useCallback as e } from "react";
-import { jsx as t } from "react/jsx-runtime";
-import n from "@plitzi/plitzi-ui/TextArea";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
+import r from "@plitzi/plitzi-ui/Checkbox";
+import i from "@plitzi/plitzi-ui/TextArea";
 //#region src/elements/basic/Text/Settings.tsx
-var r = ({ content: r = "Text", onUpdate: i }) => {
-	let a = e((e) => i?.("content", e), [i]);
-	return /* @__PURE__ */ t("div", {
+var a = ({ content: a = "Text", decorative: o = !1, onUpdate: s }) => {
+	let c = e((e) => s?.("content", e), [s]), l = e((e) => s?.("decorative", e.target.checked), [s]);
+	return /* @__PURE__ */ n("div", {
 		className: "flex h-full flex-col gap-4 py-2",
-		children: /* @__PURE__ */ t(n, {
-			value: r,
+		children: [/* @__PURE__ */ t(i, {
+			value: a,
 			label: "Content",
 			className: "h-full",
 			size: "xs",
-			onChange: a
-		})
+			onChange: c
+		}), /* @__PURE__ */ t(r, {
+			checked: o,
+			label: "Decorative (hidden from screen readers)",
+			onChange: l,
+			size: "xs"
+		})]
 	});
 };
 //#endregion
-export { r as default };
+export { a as default };

package/dist/elements/basic/Text/Text.d.ts

@@ -8,8 +8,10 @@ export type TextProps = {
      * may not say it, so nothing only it says should matter.
      */
     title?: string;
+    /** Words drawn for the look alone — a seal, a mark — that a screen reader skips, as a decorative container is. */
+    decorative?: boolean;
 };
-declare const Text: ({ ref, content, className, title }: TextProps) => import('react').JSX.Element;
+declare const Text: ({ ref, content, className, title, decorative }: TextProps) => import('react').JSX.Element;
 declare const _default: {
     (props: import('../../../Element/hocs/withElement').WithElementProps<TextProps>): import('react').JSX.Element;
     displayName: string;

package/dist/elements/basic/Text/Text.mjs

@@ -7,16 +7,17 @@ import { jsx as s, jsxs as c } from "react/jsx-runtime";
 import l from "clsx";
 import u from "@plitzi/plitzi-ui/ContentEditable";
 //#region src/elements/basic/Text/Text.tsx
-var d = ({ ref: e, content: d = "Text", className: f = "", title: p = "" }) => {
-	let { id: m } = t(), { settings: { previewMode: h }, contexts: { BuilderContext: g } } = o(), _ = g ? r(g) : void 0, v = a(() => typeof d != "string" && typeof d != "number" ? JSON.stringify(d) : !d && d !== "" && !h ? "Text" : typeof d == "number" ? `${d}` : d, [d, h]), y = i((e) => _?.updateElement(m, "content", e), [_, m]);
+var d = ({ ref: e, content: d = "Text", className: f = "", title: p = "", decorative: m = !1 }) => {
+	let { id: h } = t(), { settings: { previewMode: g }, contexts: { BuilderContext: _ } } = o(), v = _ ? r(_) : void 0, y = a(() => typeof d != "string" && typeof d != "number" ? JSON.stringify(d) : !d && d !== "" && !g ? "Text" : typeof d == "number" ? `${d}` : d, [d, g]), b = i((e) => v?.updateElement(h, "content", e), [v, h]);
 	return /* @__PURE__ */ c(n, {
 		ref: e,
 		className: l("plitzi-component__text", f),
 		title: p || void 0,
-		children: [h && v, !h && /* @__PURE__ */ s(u, {
+		...m ? { "aria-hidden": !0 } : {},
+		children: [g && y, !g && /* @__PURE__ */ s(u, {
 			className: "focus-visible:outline-hidden",
-			value: v,
-			onChange: y,
+			value: y,
+			onChange: b,
 			openMode: "doubleClick"
 		})]
 	});

package/dist/elements/basic/Text/declaration.d.ts

@@ -54,5 +54,6 @@ declare const declaration: {
 } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
     title?: string | undefined;
     content?: string | number | undefined;
+    decorative?: boolean | undefined;
 }>>;
 export default declaration;

package/dist/elements/basic/Text/index.d.ts

@@ -53,5 +53,6 @@ declare const Text: {
 } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
     title?: string | undefined;
     content?: string | number | undefined;
+    decorative?: boolean | undefined;
 }>>;
 export default Text;

package/dist/elements/declarations/index.d.ts

@@ -209,6 +209,7 @@ export declare const elementDeclarations: {
         method?: "get" | "post" | "put" | "delete" | "patch" | undefined;
         resource?: string | undefined;
         headers?: Record<string, string> | undefined;
+        notFound?: string | undefined;
         subType?: "div" | "header" | "footer" | "nav" | "main" | "section" | "article" | "aside" | "address" | "figure" | "" | undefined;
         query?: string | undefined;
         accessToken?: string | undefined;
@@ -1620,7 +1621,7 @@ export declare const elementDeclarations: {
                 readonly autoFocus: false;
                 readonly disabled: false;
                 readonly options: readonly [];
-                readonly required: true;
+                readonly required: false;
                 readonly requiredMessage: "";
                 readonly minLength: 0;
                 readonly minLengthMessage: "";
@@ -2800,6 +2801,7 @@ export declare const elementDeclarations: {
         readonly initialItems: readonly ["listItem", "listItem", "listItem"];
     } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
         source?: "none" | "controlled" | undefined;
+        label?: string | undefined;
         items?: unknown[] | undefined;
         subType?: "ul" | "ol" | undefined;
         itemKey?: string | undefined;
@@ -4250,6 +4252,7 @@ export declare const elementDeclarations: {
     } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
         title?: string | undefined;
         content?: string | number | undefined;
+        decorative?: boolean | undefined;
     }>>;
     readonly ThemeToggle: {
         readonly type: "themeToggle";

package/dist/elements/form/FormControl/FormControl.d.ts

@@ -29,6 +29,7 @@ export type FormControlProps = {
         label: string;
         value: string;
     }[];
+    /** Optional unless it says so, as an HTML field is: a required field left empty stops the submit. */
     required: boolean;
     /**
      * The rules a value has to meet before the form submits, checked by the form at submit time and by the control when

package/dist/elements/form/FormControl/FormControl.mjs

@@ -17,7 +17,7 @@ import { createStoreHook as ee } from "@plitzi/nexus/react";
 import { jsx as _, jsxs as v } from "react/jsx-runtime";
 import y from "clsx";
 //#region src/elements/form/FormControl/FormControl.tsx
-var b = ({ ref: e, className: s = "", subType: b = "text", name: x = "", label: S = "Label", hideLabel: C = !1, placeholder: w = "", autoComplete: T = !0, autoFocus: E = !1, disabled: D = !1, options: O = [], required: k = !0, maxLength: A = 0, readOnly: j = !1, value: M = "", error: N = "", handleChange: P, handleValidate: F }) => {
+var b = ({ ref: e, className: s = "", subType: b = "text", name: x = "", label: S = "Label", hideLabel: C = !1, placeholder: w = "", autoComplete: T = !0, autoFocus: E = !1, disabled: D = !1, options: O = [], required: k = !1, maxLength: A = 0, readOnly: j = !1, value: M = "", error: N = "", handleChange: P, handleValidate: F }) => {
 	let { id: I, rootId: L, visible: R, definition: { styleSelectors: z } } = t(), { settings: { previewMode: B }, contexts: { InteractionsContext: V } } = g(), { interactionsManager: H } = p(V), { useStore: U } = ee(), [W] = U("runtime.sources.form"), G = m((e) => {
 		if (P?.(e), !B) return;
 		let { target: t } = e, n = t instanceof HTMLInputElement && t.type === "checkbox" ? t.checked : t.value;

package/dist/elements/form/FormControl/Settings.mjs

@@ -9,7 +9,7 @@ import c from "@plitzi/plitzi-ui/Select";
 var l = (e) => {
 	let t = parseInt(e, 10);
 	return Number.isNaN(t) || t < 0 ? 0 : t;
-}, u = ({ subType: u = "text", name: d = "", label: f = "Label", hideLabel: p = !1, defaultValue: m = "", placeholder: h = "", autoComplete: g = !0, autoFocus: _ = !1, options: v, required: y = !0, requiredMessage: b = "", minLength: x = 0, minLengthMessage: S = "", maxLength: C = 0, maxLengthMessage: w = "", formatMessage: T = "", pattern: E = "", patternMessage: D = "", matches: O = "", matchesMessage: k = "", readOnly: A = !1, disabled: j = !1, previewError: M = !1, onUpdate: N }) => {
+}, u = ({ subType: u = "text", name: d = "", label: f = "Label", hideLabel: p = !1, defaultValue: m = "", placeholder: h = "", autoComplete: g = !0, autoFocus: _ = !1, options: v, required: y = !1, requiredMessage: b = "", minLength: x = 0, minLengthMessage: S = "", maxLength: C = 0, maxLengthMessage: w = "", formatMessage: T = "", pattern: E = "", patternMessage: D = "", matches: O = "", matchesMessage: k = "", readOnly: A = !1, disabled: j = !1, previewError: M = !1, onUpdate: N }) => {
 	let P = [
 		"text",
 		"textarea",

package/dist/elements/form/FormControl/declaration.d.ts

@@ -35,7 +35,7 @@ declare const declaration: {
             readonly autoFocus: false;
             readonly disabled: false;
             readonly options: readonly [];
-            readonly required: true;
+            readonly required: false;
             readonly requiredMessage: "";
             readonly minLength: 0;
             readonly minLengthMessage: "";

package/dist/elements/form/FormControl/declaration.mjs

@@ -63,7 +63,7 @@ var n = {
 	"padding-left": "0px",
 	display: "block",
 	...c,
-	"background-color": "inherit",
+	"background-color": "transparent",
 	color: "inherit",
 	"line-height": "inherit",
 	"font-family": "inherit",
@@ -186,7 +186,7 @@ var n = {
 			autoFocus: !1,
 			disabled: !1,
 			options: [],
-			required: !0,
+			required: !1,
 			requiredMessage: "",
 			minLength: 0,
 			minLengthMessage: "",

package/dist/elements/form/FormControl/index.d.ts

@@ -23,7 +23,7 @@ declare const FormControl: {
             readonly autoFocus: false;
             readonly disabled: false;
             readonly options: readonly [];
-            readonly required: true;
+            readonly required: false;
             readonly requiredMessage: "";
             readonly minLength: 0;
             readonly minLengthMessage: "";

package/dist/elements/provider/ApiContainer/ApiContainer.d.ts

@@ -82,6 +82,13 @@ export type ApiContainerProps = {
      * flight. A text field in the builder, hence the string.
      */
     refreshSeconds?: number | string;
+    /**
+     * With `runtime: 'server'`: when this provider's answer means the address shows nothing — `{{ source.found == false
+     * }}` — a template against the answer, as `visible` is. The page server reads it once the answer is in and sends the
+     * page with status 404, rendered as it is written (its own "not found" part). Read by the server alone: a browser
+     * provider's answer arrives after the status was sent.
+     */
+    notFound?: string;
 };
 declare const ApiContainer: ({ ref, className, children, query, method, accessToken, when, headers, mockData, subType, credentials, singleRecord, pagination, pageParam, renderWhileLoading, loadingSlot, cache, staleTime, gcTime, refreshSeconds, connector, action, input }: ApiContainerProps) => import('react').JSX.Element;
 declare const _default: {

package/dist/elements/provider/ApiContainer/declaration.d.ts

@@ -172,6 +172,7 @@ declare const declaration: {
     method?: "get" | "post" | "put" | "delete" | "patch" | undefined;
     resource?: string | undefined;
     headers?: Record<string, string> | undefined;
+    notFound?: string | undefined;
     subType?: "div" | "header" | "footer" | "nav" | "main" | "section" | "article" | "aside" | "address" | "figure" | "" | undefined;
     query?: string | undefined;
     accessToken?: string | undefined;

package/dist/elements/provider/ApiContainer/declaration.mjs

@@ -141,7 +141,7 @@ var n = e()({
 		definition: {
 			label: "Api Container",
 			type: "apiContainer",
-			description: "Fetches data from a backend HTTP API (its `query`/`method`/`credentials`) and exposes the response as a data source ITS DESCENDANTS bind to (source `apiContainer_<id>.data`; only elements inside it can consume it). This is how you get backend data into the frontend. Its `mockData` prop is builder-only sample data — the published runtime fetches the real `query`, so always set a real query for production. With `cache: true` a browser request is kept for `staleTime` seconds (default 30) and shared with every provider asking the same thing; it is off unless set. A flow refreshes it with `performQuery` or the global `invalidateQueries` step, and `refreshSeconds` makes it ask again on its own every N seconds (either runtime; paused while the tab is hidden) — the way to keep a queue, feed or status board current without a plugin. Its `subType` (container tag) is empty by default, and then it renders NO element of its own: its children lay out directly in its parent, and any class, variant or style binding on it applies to nothing. To style the provider itself give it a tag (`subType: \"div\"`, `section`, …); otherwise style its parent or a child.",
+			description: "Fetches data from a backend HTTP API (its `query`/`method`/`credentials`) and exposes the response as a data source ITS DESCENDANTS bind to (source `apiContainer_<id>.data`; only elements inside it can consume it). This is how you get backend data into the frontend. Its `mockData` prop is builder-only sample data — the published runtime fetches the real `query`, so always set a real query for production. With `cache: true` a browser request is kept for `staleTime` seconds (default 30) and shared with every provider asking the same thing; it is off unless set. A flow refreshes it with `performQuery` or the global `invalidateQueries` step, and `refreshSeconds` makes it ask again on its own every N seconds (either runtime; paused while the tab is hidden) — the way to keep a queue, feed or status board current without a plugin. A server provider (`runtime: \"server\"`) whose answer means the address shows nothing — a record not found — says so in `notFound`, a template against its answer (`{{ source.found == false }}`): the page is sent with status 404, rendered as written. Its `subType` (container tag) is empty by default, and then it renders NO element of its own: its children lay out directly in its parent, and any class, variant or style binding on it applies to nothing. To style the provider itself give it a tag (`subType: \"div\"`, `section`, …); otherwise style its parent or a child.",
 			items: [],
 			bindings: {},
 			styleSelectors: { base: "" },

package/dist/elements/provider/ApiContainer/index.d.ts

@@ -171,6 +171,7 @@ declare const ApiContainer: {
     method?: "get" | "post" | "put" | "delete" | "patch" | undefined;
     resource?: string | undefined;
     headers?: Record<string, string> | undefined;
+    notFound?: string | undefined;
     subType?: "div" | "header" | "footer" | "nav" | "main" | "section" | "article" | "aside" | "address" | "figure" | "" | undefined;
     query?: string | undefined;
     accessToken?: string | undefined;

package/dist/elements/structure/List/List.d.ts

@@ -11,8 +11,10 @@ export type ListProps<T = unknown> = {
      * filtered or reordered, and mounts again when its item changes. Left out: the item's `id`, else its position.
      */
     itemKey?: string;
+    /** What a screen reader calls the list — a group of options, a set of results — said before its rows. */
+    label?: string;
 };
-declare const List: ({ ref, className, subType, children, items, source, itemKey }: ListProps) => import('react').JSX.Element;
+declare const List: ({ ref, className, subType, children, items, source, itemKey, label }: ListProps) => import('react').JSX.Element;
 declare const _default: {
     (props: import('../../../Element/hocs/withElement').WithElementProps<ListProps<unknown>>): import('react').JSX.Element;
     displayName: string;

package/dist/elements/structure/List/List.mjs

@@ -3,7 +3,7 @@ import t from "./modes/ListBasic.mjs";
 import n from "./modes/ListControlled/index.mjs";
 import { jsx as r } from "react/jsx-runtime";
 //#region src/elements/structure/List/List.tsx
-var i = ({ ref: e, className: i = "", subType: a = "ul", children: o, items: s = [], source: c = "none", itemKey: l }) => {
+var i = ({ ref: e, className: i = "", subType: a = "ul", children: o, items: s = [], source: c = "none", itemKey: l, label: u = "" }) => {
 	switch (c) {
 		case "controlled": return /* @__PURE__ */ r(n, {
 			ref: e,
@@ -11,12 +11,14 @@ var i = ({ ref: e, className: i = "", subType: a = "ul", children: o, items: s =
 			subType: a,
 			items: s,
 			itemKey: l,
+			label: u,
 			children: o
 		});
 		default: return /* @__PURE__ */ r(t, {
 			ref: e,
 			className: i,
 			subType: a,
+			label: u,
 			children: o
 		});
 	}

package/dist/elements/structure/List/Settings.d.ts

@@ -2,7 +2,8 @@ type SettingsProps = {
     subType?: 'ul' | 'ol';
     source?: 'none' | 'controlled';
     itemKey?: string;
+    label?: string;
     onUpdate?: (key: string, value: string | boolean | number) => void;
 };
-declare const Settings: ({ subType, source, itemKey, onUpdate }: SettingsProps) => import('react').JSX.Element;
+declare const Settings: ({ subType, source, itemKey, label, onUpdate }: SettingsProps) => import('react').JSX.Element;
 export default Settings;

package/dist/elements/structure/List/Settings.mjs

@@ -3,15 +3,15 @@ import { jsx as t, jsxs as n } from "react/jsx-runtime";
 import r from "@plitzi/plitzi-ui/Input";
 import i from "@plitzi/plitzi-ui/Select";
 //#region src/elements/structure/List/Settings.tsx
-var a = ({ subType: a = "ul", source: o = "none", itemKey: s = "", onUpdate: c }) => {
-	let l = e((e) => (t) => c?.(e, t), [c]);
+var a = ({ subType: a = "ul", source: o = "none", itemKey: s = "", label: c = "", onUpdate: l }) => {
+	let u = e((e) => (t) => l?.(e, t), [l]);
 	return /* @__PURE__ */ n("div", {
 		className: "flex flex-col gap-4 py-2",
 		children: [
 			/* @__PURE__ */ n(i, {
 				label: "Source",
 				value: o,
-				onChange: l("source"),
+				onChange: u("source"),
 				size: "xs",
 				children: [/* @__PURE__ */ t("option", {
 					value: "none",
@@ -27,12 +27,12 @@ var a = ({ subType: a = "ul", source: o = "none", itemKey: s = "", onUpdate: c }
 				placeholder: "id",
 				value: s,
 				title: "The field of each item that names it, so a row stays with its item when the list is filtered.",
-				onChange: l("itemKey")
+				onChange: u("itemKey")
 			}),
 			/* @__PURE__ */ n(i, {
 				label: "List Type",
 				value: a,
-				onChange: l("subType"),
+				onChange: u("subType"),
 				size: "xs",
 				children: [/* @__PURE__ */ t("option", {
 					value: "ul",
@@ -41,6 +41,13 @@ var a = ({ subType: a = "ul", source: o = "none", itemKey: s = "", onUpdate: c }
 					value: "ol",
 					children: "Ordered"
 				})]
+			}),
+			/* @__PURE__ */ t(r, {
+				value: c,
+				label: "List Name",
+				placeholder: "e.g. Kinds of capsule, Search results",
+				onChange: u("label"),
+				size: "xs"
 			})
 		]
 	});

package/dist/elements/structure/List/declaration.d.ts

@@ -92,6 +92,7 @@ declare const declaration: {
     readonly initialItems: readonly ["listItem", "listItem", "listItem"];
 } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
     source?: "none" | "controlled" | undefined;
+    label?: string | undefined;
     items?: unknown[] | undefined;
     subType?: "ul" | "ol" | undefined;
     itemKey?: string | undefined;

package/dist/elements/structure/List/index.d.ts

@@ -143,6 +143,7 @@ declare const List: {
     initialItems: readonly ["listItem", "listItem", "listItem"];
     __attributes: Partial<{
         source?: "none" | "controlled" | undefined;
+        label?: string | undefined;
         items?: unknown[] | undefined;
         subType?: "ul" | "ol" | undefined;
         itemKey?: string | undefined;

package/dist/elements/structure/List/modes/ListBasic.d.ts

@@ -4,6 +4,8 @@ export type ListBasicProps = {
     className?: string;
     subType?: 'ul' | 'ol';
     children?: ReactNode;
+    /** The list's accessible name. */
+    label?: string;
 };
-declare const ListBasic: ({ ref, className, subType, children }: ListBasicProps) => import('react').JSX.Element;
+declare const ListBasic: ({ ref, className, subType, children, label }: ListBasicProps) => import('react').JSX.Element;
 export default ListBasic;

package/dist/elements/structure/List/modes/ListBasic.mjs

@@ -2,10 +2,11 @@ import { RootElement as e } from "../../../../Element/RootElement.mjs";
 import { jsx as t } from "react/jsx-runtime";
 import n from "clsx";
 //#region src/elements/structure/List/modes/ListBasic.tsx
-var r = ({ ref: r, className: i = "", subType: a = "ul", children: o }) => /* @__PURE__ */ t(e, {
+var r = ({ ref: r, className: i = "", subType: a = "ul", children: o, label: s = "" }) => /* @__PURE__ */ t(e, {
 	ref: r,
 	tag: a,
 	className: n("plitzi-component__list", i),
+	"aria-label": s || void 0,
 	children: o
 });
 //#endregion

package/dist/elements/structure/List/modes/ListControlled/ListControlled.d.ts

@@ -7,6 +7,8 @@ export type ListControlledProps<T = unknown> = {
     children: ReactNode;
     items: T[];
     itemKey?: string;
+    /** The list's accessible name. */
+    label?: string;
 };
-declare const ListControlled: ({ ref, className, subType, children, items, itemKey }: ListControlledProps) => import('react').JSX.Element;
+declare const ListControlled: ({ ref, className, subType, children, items, itemKey, label }: ListControlledProps) => import('react').JSX.Element;
 export default ListControlled;

package/dist/elements/structure/List/modes/ListControlled/ListControlled.mjs

@@ -13,28 +13,29 @@ import m from "clsx";
 import h from "@plitzi/sdk-shared/dataSource/helpers/getSourceName";
 import g from "@plitzi/sdk-shared/dataSource/hooks/useRegisterSource";
 //#region src/elements/structure/List/modes/ListControlled/ListControlled.tsx
-var _ = ({ ref: _, className: v = "", subType: y = "ul", children: b, items: x = [], itemKey: S }) => {
-	let { id: C, definition: { label: w } } = e(), T = h(i.sourceType, C), { settings: { previewMode: E } } = s(), D = o(() => Array.isArray(x) ? x : [], [x]), O = o(() => n(D, S), [D, S]), k = a(() => d({
-		item: c(D, "0", {}),
+var _ = ({ ref: _, className: v = "", subType: y = "ul", children: b, items: x = [], itemKey: S, label: C = "" }) => {
+	let { id: w, definition: { label: T } } = e(), E = h(i.sourceType, w), { settings: { previewMode: D } } = s(), O = o(() => Array.isArray(x) ? x : [], [x]), k = o(() => n(O, S), [O, S]), A = a(() => d({
+		item: c(O, "0", {}),
 		index: 0
 	}).reduce((e, t) => [...e, {
 		path: t,
 		name: t
-	}], []), [D]), A = o(() => T ? { runtime: { sources: { [T]: { items: D } } } } : u, [T, D]);
+	}], []), [O]), j = o(() => E ? { runtime: { sources: { [E]: { items: O } } } } : u, [E, O]);
 	return g({
-		id: C,
-		source: T,
-		name: w || `List - ${C}`,
-		fields: k
+		id: w,
+		source: E,
+		name: T || `List - ${w}`,
+		fields: A
 	}), /* @__PURE__ */ p(t, {
 		ref: _,
 		tag: y,
-		className: m("plitzi-component__controlled-list", v, { "controlled-list--build-mode": !E }),
+		"aria-label": C || void 0,
+		className: m("plitzi-component__controlled-list", v, { "controlled-list--build-mode": !D }),
 		children: [/* @__PURE__ */ f(l, {
 			inherit: "live",
-			name: `List:${C}`,
-			value: A,
-			children: D.map((e, t) => !b || Array.isArray(b) && b.length === 0 ? /* @__PURE__ */ f("div", {
+			name: `List:${w}`,
+			value: j,
+			children: O.map((e, t) => !b || Array.isArray(b) && b.length === 0 ? /* @__PURE__ */ f("div", {
 				className: "plitzi-component__controlled-list-item controlled-list--empty",
 				children: /* @__PURE__ */ f("div", {
 					className: "controlled-list-item__counter",
@@ -42,12 +43,12 @@ var _ = ({ ref: _, className: v = "", subType: y = "ul", children: b, items: x =
 				})
 			}, t) : /* @__PURE__ */ f(r, {
 				index: t,
-				isTemplate: t !== 0 && !E,
+				isTemplate: t !== 0 && !D,
 				record: e,
-				source: T,
+				source: E,
 				children: b
-			}, O[t]))
-		}), !E && D.length === 0 && /* @__PURE__ */ f("div", {
+			}, k[t]))
+		}), !D && O.length === 0 && /* @__PURE__ */ f("div", {
 			className: "controlled-list controlled-list--empty",
 			children: "This list does not contain any items"
 		})]

package/dist/index.d.ts

@@ -2690,6 +2690,7 @@ export declare const defaultElements: {
     } & import('@plitzi/sdk-shared/authoring/declare').ElementAttributesBrand<Partial<{
         title?: string | undefined;
         content?: string | number | undefined;
+        decorative?: boolean | undefined;
     }>>;
     themeToggle: {
         (props: import('./Element/hocs/withElement').WithElementProps<import('./elements/basic/ThemeToggle/ThemeToggle').ThemeToggleProps>): import('react').JSX.Element;
@@ -2963,6 +2964,7 @@ export declare const defaultElements: {
         initialItems: readonly ["listItem", "listItem", "listItem"];
         __attributes: Partial<{
             source?: "none" | "controlled" | undefined;
+            label?: string | undefined;
             items?: unknown[] | undefined;
             subType?: "ul" | "ol" | undefined;
             itemKey?: string | undefined;
@@ -3470,7 +3472,7 @@ export declare const defaultElements: {
                 readonly autoFocus: false;
                 readonly disabled: false;
                 readonly options: readonly [];
-                readonly required: true;
+                readonly required: false;
                 readonly requiredMessage: "";
                 readonly minLength: 0;
                 readonly minLengthMessage: "";
@@ -4380,6 +4382,7 @@ export declare const defaultElements: {
         method?: "get" | "post" | "put" | "delete" | "patch" | undefined;
         resource?: string | undefined;
         headers?: Record<string, string> | undefined;
+        notFound?: string | undefined;
         subType?: "div" | "header" | "footer" | "nav" | "main" | "section" | "article" | "aside" | "address" | "figure" | "" | undefined;
         query?: string | undefined;
         accessToken?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-elements",
-  "version": "0.38.8",
+  "version": "0.38.9",
   "license": "AGPL-3.0",
   "files": [
     "dist"
@@ -1371,12 +1371,12 @@
     "@dr.pogodin/react-helmet": "^3.3.2",
     "@plitzi/nexus": "^1.4.0",
     "@plitzi/plitzi-ui": "^1.6.32",
-    "@plitzi/sdk-auth": "0.38.8",
-    "@plitzi/sdk-event-bridge": "0.38.8",
-    "@plitzi/sdk-interactions": "0.38.8",
-    "@plitzi/sdk-navigation": "0.38.8",
-    "@plitzi/sdk-schema": "0.38.8",
-    "@plitzi/sdk-shared": "0.38.8",
+    "@plitzi/sdk-auth": "0.38.9",
+    "@plitzi/sdk-event-bridge": "0.38.9",
+    "@plitzi/sdk-interactions": "0.38.9",
+    "@plitzi/sdk-navigation": "0.38.9",
+    "@plitzi/sdk-schema": "0.38.9",
+    "@plitzi/sdk-shared": "0.38.9",
     "clsx": "^2.1.1",
     "immer": "^11.1.21",
     "react-markdown": "^10.1.0",