@imfusion/web-ui 0.8.1-dev.6.g254fcc45 → 0.8.1-dev.9.gda40b9aa

package/CHANGELOG.md

@@ -15,6 +15,13 @@
 - Agent skills — Nikolaus Brunner <brunner@imfusion.com>
   - `imf-web-ui-conventions` declares named functions, local component helpers included, with `function`, and keeps
     inline callbacks as arrows.
+  - `imf-web-ui-conventions` loads route data with `queryClient.query({ ...options, staleTime: "static" })` in place of the
+    deprecated `ensureQueryData`.
+
+### Fixed
+
+- Components — Nikolaus Brunner <brunner@imfusion.com>
+  - Screen readers announce `Field.Error` when its message appears; it has `role="alert"` by default.
 
 ---
 

package/dist/components/field/field.d.ts

@@ -29,8 +29,11 @@ export declare function Control(props: React.ComponentProps<typeof FieldPrimitiv
 export declare namespace Control {
     var displayName: string;
 }
-/** Field.Error — an inline validation message shown when its match condition fails. */
-export declare function Error(props: React.ComponentProps<typeof FieldPrimitive.Error>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Field.Error — an inline validation message shown when its match condition fails.
+ * It announces itself with `role="alert"`; pass another `role` to quiet it.
+ */
+export declare function Error({ role, ...props }: React.ComponentProps<typeof FieldPrimitive.Error>): import("react/jsx-runtime").JSX.Element;
 export declare namespace Error {
     var displayName: string;
 }

package/dist/index.js

@@ -343,11 +343,12 @@ function pt(e) {
 	});
 }
 pt.displayName = "Field.Control";
-function mt(e) {
+function mt({ role: e = "alert", ...n }) {
 	return /* @__PURE__ */ h(_.Error, {
-		...e,
+		...n,
+		role: e,
 		"data-imf-ui-component": "Field.Error",
-		className: (n) => ct({ className: t(e.className, n) })
+		className: (e) => ct({ className: t(n.className, e) })
 	});
 }
 mt.displayName = "Field.Error";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.8.1-dev.6.g254fcc45",
+  "version": "0.8.1-dev.9.gda40b9aa",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "homepage": "https://imfusion.com",

package/src/docgen/doc.gen.json

@@ -1963,7 +1963,7 @@
       },
       {
         "name": "Field.Error",
-        "description": "Field.Error — an inline validation message shown when its match condition fails.",
+        "description": "Field.Error — an inline validation message shown when its match condition fails.\nIt announces itself with `role=\"alert\"`; pass another `role` to quiet it.",
         "props": [
           {
             "name": "className",

package/src/llms/skills/imf-web-ui-conventions/topics/authentication.md

@@ -19,7 +19,8 @@ Use one server-backed current-user query as the identity source:
 
 - Put it in `api/auth/queries.ts` and define its key and schema with the [data.md](data.md) pattern.
 - Expose query options as `context.api.auth.getUser()`.
-- Call `ensureQueryData` in a loader or a query hook in a component.
+- Call `queryClient.query({ ...options, staleTime: "static" })` in a loader (see [data.md](data.md)) or a query hook in a
+  component.
 - Keep credentials and access tokens out of React state.
 - Do not infer authentication from local storage, decoded tokens, route flags, or permission-gated UI.
 

package/src/llms/skills/imf-web-ui-conventions/topics/data.md

@@ -85,9 +85,11 @@ export function getDetails(options?: QueryOptions<User>) {
 }
 ```
 
-Callers choose `ensureQueryData`, `useSuspenseQuery`, or another Query API. Mutation factories likewise return
-`mutationOptions`, own their mutation key and parsing, and are passed to `useMutation`; do not inline those options at the
-call site.
+Callers choose `queryClient.query`, `useSuspenseQuery`, or another Query API. A router loader reads the cache with
+`queryClient.query({ ...options, staleTime: "static" })`, not the deprecated `ensureQueryData` or `fetchQuery`. Keep
+`"static"`: without it the factory's `staleTime` applies (default 0), so every loader run waits on the network and the page's
+`useQuery` refetches on mount. Mutation factories likewise return `mutationOptions`, own their mutation key and parsing, and
+are passed to `useMutation`; do not inline those options at the call site.
 
 ## Router context access