shelving 1.271.3 → 1.271.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shelving",
-	"version": "1.271.3",
+	"version": "1.271.4",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"repository": {
 		"type": "git",

package/ui/block/List.d.ts

@@ -1,4 +1,5 @@
 import type { ReactElement, ReactNode } from "react";
+import type { ImmutableArray } from "../../util/array.js";
 import { type BlockVariants } from "../style/Block.js";
 import { type GapVariants } from "../style/Gap.js";
 /**
@@ -7,8 +8,8 @@ import { type GapVariants } from "../style/Gap.js";
  * @see https://shelving.cc/ui/ListProps
  */
 export interface ListProps extends GapVariants, BlockVariants {
-    children: ReactNode[];
-    ordered?: boolean;
+    readonly children: ImmutableArray<ReactNode>;
+    readonly ordered?: boolean | undefined;
 }
 /**
  * List block — wraps each child in an `<li>` and renders an `<ul>` or `<ol>`.

package/ui/block/List.tsx

@@ -1,4 +1,5 @@
 import type { ReactElement, ReactNode } from "react";
+import type { ImmutableArray } from "../../util/array.js";
 import { type BlockVariants, getBlockClass } from "../style/Block.js";
 import { type GapVariants, getGapClass } from "../style/Gap.js";
 import { getClass, getModuleClass } from "../util/css.js";
@@ -13,8 +14,8 @@ const LIST_UNORDERED_CLASS = getModuleClass(LIST_CSS, "unordered");
  * @see https://shelving.cc/ui/ListProps
  */
 export interface ListProps extends GapVariants, BlockVariants {
-	children: ReactNode[];
-	ordered?: boolean;
+	readonly children: ImmutableArray<ReactNode>;
+	readonly ordered?: boolean | undefined;
 }
 
 /**

package/ui/input/Popover.d.ts

@@ -7,7 +7,7 @@ import type { Callback } from "../../util/function.js";
  *
  * @see https://shelving.cc/ui/PopoverChildren
  */
-export type PopoverChildren = [
+export type PopoverChildren = readonly [
     /**
      * First child of the <Popover> is element that activates the popover.
      * - Should be a `<Button>` or `<Input>` that activates or provides the children.

package/ui/input/Popover.tsx

@@ -15,7 +15,7 @@ import styles from "./Popover.module.css";
  *
  * @see https://shelving.cc/ui/PopoverChildren
  */
-export type PopoverChildren = [
+export type PopoverChildren = readonly [
 	/**
 	 * First child of the <Popover> is element that activates the popover.
 	 * - Should be a `<Button>` or `<Input>` that activates or provides the children.

package/ui/menu/Menu.d.ts

@@ -28,7 +28,7 @@ export interface MenuItemProps extends ClickableProps {
      * The first child becomes the link label (rendered inside the `<a>`).
      * - Any additional children form the submenu — only rendered when this item is "proud" (an ancestor of the current page). The caller is responsible for wrapping the submenu in a nested `<Menu>` if it wants the CSS `.menu .menu` descendant rules to apply.
      */
-    readonly children: ReactNode | [ReactNode, ...ReactNode[]];
+    readonly children: ReactNode | readonly [ReactNode, ...ReactNode[]];
 }
 /**
  * A `<li>` containing an `<a>` link, plus optional submenu content shown when this item is "proud".

package/ui/menu/Menu.tsx

@@ -52,7 +52,7 @@ export interface MenuItemProps extends ClickableProps {
 	 * The first child becomes the link label (rendered inside the `<a>`).
 	 * - Any additional children form the submenu — only rendered when this item is "proud" (an ancestor of the current page). The caller is responsible for wrapping the submenu in a nested `<Menu>` if it wants the CSS `.menu .menu` descendant rules to apply.
 	 */
-	readonly children: ReactNode | [ReactNode, ...ReactNode[]];
+	readonly children: ReactNode | readonly [ReactNode, ...ReactNode[]];
 }
 
 /**