Devana fixes

README.md

@@ -164,6 +164,13 @@ Structure field:
 }
 ```
 
+The structure widget also accepts `min` and `max` row counts. These constrain
+the interactive controls — the Add button is disabled at `max` and the Remove
+button is disabled at `min` — guiding editors back within bounds. They are not
+enforced on externally supplied values: a stored array outside the limits is
+shown as-is rather than silently trimmed (which would drop data) or padded with
+empty rows (which would dirty the entry on open).
+
 Choices with horizontal cards:
 
 ```json

src/admin-locale.ts

@@ -1,8 +1,15 @@
+/**
+ * Admin UI locale from the EmDash `emdash-locale` cookie.
+ *
+ * Widgets use this when options omit an explicit locale so labels track the
+ * signed-in admin language.
+ */
 import { useEffect, useState } from "react";
 import { DEFAULT_LOCALE, normalizeLocale } from "./i18n";
 
 const LOCALE_COOKIE_NAME = "emdash-locale";
 
+/** Reads the current admin locale from `document.cookie`, with SSR-safe fallback. */
 export function readAdminLocale(fallback = DEFAULT_LOCALE): string {
   const normalizedFallback = normalizeLocale(fallback);
 
@@ -23,6 +30,7 @@ export function readAdminLocale(fallback = DEFAULT_LOCALE): string {
   }
 }
 
+/** Reactive admin locale that resyncs on focus and a short polling interval. */
 export function useAdminLocale(fallback = DEFAULT_LOCALE): string {
   const [locale, setLocale] = useState(() => readAdminLocale(fallback));