@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/components/form/validation-errors/scroll-to-first-error.utils.js

@@ -22,11 +22,20 @@
  *    insertion order, not visual order) and pick the first element whose
  *    `data-field` equals an errored path or is a structural ancestor of one
  *    (e.g. the `checklist` array section for a `checklist.0.label` error).
- * 3. Scroll it into view (centered, smooth) and focus the first focusable
+ * 3. Ask every section panel enclosing it to show itself ({@link requestFieldReveal}): inside a form, a tab not
+ *    selected, an accordion row closed or a step not current keeps its fields mounted but hidden, and a hidden field
+ *    cannot be scrolled to or focused. When a panel had to be shown, the scroll waits for it to render.
+ * 4. Scroll it into view (centered, smooth) and focus the first focusable
  *    control inside it, so keyboard users land where the repair happens.
  *
  * The `[name="..."]` fallback covers controls rendered outside a chrome wrapper.
  */
+import { FormContextUtils } from '../form-context.utils.js';
+import { requestFieldReveal, whenRendered } from './field-reveal.js';
+/**
+ * The attribute the form error summary carries, so the scroll can reach it when the error belongs to no field.
+ */
+export const FORM_ERROR_SUMMARY_ATTRIBUTE = 'data-form-error-summary';
 /**
  * Flatten a react-hook-form `FieldErrors` tree into dotted field paths.
  *
@@ -101,8 +110,43 @@ export function scrollAndFocusFirstErroredField(erroredPaths) {
             }
         }
     }
-    if (!target)
+    if (!target) {
+        // An error that names no field (a rule across fields, a refusal of the whole record) has nothing to scroll to, so
+        // the click on Save moved nothing. The summary lists it: bring the summary on screen and focus it, as the error
+        // summary pattern does. It renders with the errors, so it may not be in the DOM yet.
+        if (erroredPaths.some((path) => FormContextUtils.isFormLevelErrorPath(path))) {
+            focusFormErrorSummaryWhenRendered();
+            return true;
+        }
         return false;
+    }
+    const revealedTarget = target;
+    if (requestFieldReveal(revealedTarget))
+        whenRendered(revealedTarget, () => scrollAndFocus(revealedTarget));
+    else
+        scrollAndFocus(revealedTarget);
+    return true;
+}
+/** Scrolls the first form error summary on the page into view and focuses it, polling a few frames for it to render. */
+function focusFormErrorSummaryWhenRendered(maxFrames = 20) {
+    const schedule = typeof requestAnimationFrame === 'function' ? requestAnimationFrame : (step) => setTimeout(step, 16);
+    let frames = 0;
+    const step = () => {
+        const summary = document.querySelector(`[${FORM_ERROR_SUMMARY_ATTRIBUTE}]`);
+        if (summary) {
+            summary.scrollIntoView({ behavior: 'smooth', block: 'center' });
+            summary.focus({ preventScroll: true });
+            return;
+        }
+        if (frames < maxFrames) {
+            frames += 1;
+            schedule(step);
+        }
+    };
+    step();
+}
+/** Scrolls `target` to the centre of the viewport and focuses its first focusable control. */
+function scrollAndFocus(target) {
     target.scrollIntoView({ behavior: 'smooth', block: 'center' });
     // Focus after the smooth scroll has started; `preventScroll` keeps the focus
     // jump from fighting the centered smooth scroll already in flight.
@@ -122,6 +166,5 @@ export function scrollAndFocusFirstErroredField(erroredPaths) {
             }
         }
     }, 100);
-    return true;
 }
 //# sourceMappingURL=scroll-to-first-error.utils.js.map

package/dist/esm/components/form/validation-errors/scroll-to-first-error.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-to-first-error.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * scroll-to-first-error.utils — bring the first invalid field into view after a\n * failed submit.\n *\n * ## Why this exists (audit finding D4)\n *\n * On submit-validation failure the errors render inline next to their fields,\n * but the viewport stays wherever the user was — typically at the submit button\n * at the BOTTOM of a long form, while the errored required fields sit invisible\n * at the top. The user sees a click that \"did nothing\".\n *\n * ## How the DOM lookup works\n *\n * Every visible `FormFieldChrome` mode renders `data-field={fieldName}` on its\n * outer wrapper (documented as the \"data-field safety net\" in\n * `FormFieldChrome.tsx`), and `AutomatedArrayField` renders it on the array's\n * `ContentSection`. We therefore:\n *\n * 1. Flatten the error object (react-hook-form `FieldErrors` or a server\n *    validation-error map) into dotted field paths.\n * 2. Walk `[data-field]` elements **in DOM order** (error-object key order is\n *    insertion order, not visual order) and pick the first element whose\n *    `data-field` equals an errored path or is a structural ancestor of one\n *    (e.g. the `checklist` array section for a `checklist.0.label` error).\n * 3. Scroll it into view (centered, smooth) and focus the first focusable\n *    control inside it, so keyboard users land where the repair happens.\n *\n * The `[name=\"...\"]` fallback covers controls rendered outside a chrome wrapper.\n */\n\nimport type { FieldErrors } from 'react-hook-form';\n\n/**\n * Flatten a react-hook-form `FieldErrors` tree into dotted field paths.\n *\n * An error LEAF is any node carrying a string `message` or a string `type`\n * (the shape both the standard-schema resolver and `setError` produce). Array\n * `root` errors are attributed to the array path itself (`checklist.root` →\n * `checklist`). Order follows the error object's own insertion order — DOM\n * ordering is applied later by {@link scrollAndFocusFirstErroredField}.\n */\nexport function collectErroredFieldPaths(errors: FieldErrors | Record<string, unknown>): string[] {\n  const paths: string[] = [];\n\n  const walk = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object') return;\n    const record = node as Record<string, unknown>;\n\n    // Error leaf: RHF error objects carry `type` (string) and usually `message`.\n    if (typeof record.message === 'string' || typeof record.type === 'string') {\n      if (path) paths.push(path);\n      return;\n    }\n\n    for (const [key, value] of Object.entries(record)) {\n      if (key === 'root') {\n        // Array/object root errors belong to the container path itself.\n        walk(value, path);\n        continue;\n      }\n      walk(value, path ? `${path}.${key}` : key);\n    }\n  };\n\n  walk(errors, '');\n  return paths;\n}\n\nfunction escapeAttributeValue(value: string): string {\n  // CSS.escape is available in every supported browser; fall back to a\n  // conservative quote/backslash escape for non-DOM test environments.\n  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n    return CSS.escape(value);\n  }\n  return value.replace(/[\"\\\\]/g, '\\\\$&');\n}\n\n/**\n * Scroll the first errored field (in DOM order) into view and focus it.\n *\n * @param erroredPaths dotted field paths, e.g. from {@link collectErroredFieldPaths}\n *   or `Object.keys(serverValidationErrors)`.\n * @returns `true` when a matching element was found and scrolled.\n */\nexport function scrollAndFocusFirstErroredField(erroredPaths: string[]): boolean {\n  if (typeof document === 'undefined' || erroredPaths.length === 0) return false;\n\n  const pathSet = new Set(erroredPaths);\n  let target: HTMLElement | null = null;\n\n  // DOM order is the authoritative \"first\" — the error map's key order is not.\n  const chromeElements = document.querySelectorAll<HTMLElement>('[data-field]');\n  for (const element of chromeElements) {\n    const dataField = element.getAttribute('data-field');\n    if (!dataField) continue;\n    if (pathSet.has(dataField) || erroredPaths.some((path) => path.startsWith(`${dataField}.`))) {\n      target = element;\n      break;\n    }\n  }\n\n  // Fallback: controls registered by name without a chrome wrapper.\n  if (!target) {\n    for (const path of erroredPaths) {\n      const byName = document.querySelector<HTMLElement>(`[name=\"${escapeAttributeValue(path)}\"]`);\n      if (byName) {\n        target = byName;\n        break;\n      }\n    }\n  }\n\n  if (!target) return false;\n\n  target.scrollIntoView({ behavior: 'smooth', block: 'center' });\n\n  // Focus after the smooth scroll has started; `preventScroll` keeps the focus\n  // jump from fighting the centered smooth scroll already in flight.\n  const focusTarget = target;\n  setTimeout(() => {\n    if (!document.body.contains(focusTarget)) return;\n    const focusable = focusTarget.matches('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])')\n      ? focusTarget\n      : focusTarget.querySelector<HTMLElement>('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])');\n    if (focusable && document.body.contains(focusable)) {\n      try {\n        focusable.focus({ preventScroll: true });\n      } catch {\n        focusable.focus();\n      }\n    }\n  }, 100);\n\n  return true;\n}\n"]}
+{"version":3,"file":"scroll-to-first-error.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * scroll-to-first-error.utils — bring the first invalid field into view after a\n * failed submit.\n *\n * ## Why this exists (audit finding D4)\n *\n * On submit-validation failure the errors render inline next to their fields,\n * but the viewport stays wherever the user was — typically at the submit button\n * at the BOTTOM of a long form, while the errored required fields sit invisible\n * at the top. The user sees a click that \"did nothing\".\n *\n * ## How the DOM lookup works\n *\n * Every visible `FormFieldChrome` mode renders `data-field={fieldName}` on its\n * outer wrapper (documented as the \"data-field safety net\" in\n * `FormFieldChrome.tsx`), and `AutomatedArrayField` renders it on the array's\n * `ContentSection`. We therefore:\n *\n * 1. Flatten the error object (react-hook-form `FieldErrors` or a server\n *    validation-error map) into dotted field paths.\n * 2. Walk `[data-field]` elements **in DOM order** (error-object key order is\n *    insertion order, not visual order) and pick the first element whose\n *    `data-field` equals an errored path or is a structural ancestor of one\n *    (e.g. the `checklist` array section for a `checklist.0.label` error).\n * 3. Ask every section panel enclosing it to show itself ({@link requestFieldReveal}): inside a form, a tab not\n *    selected, an accordion row closed or a step not current keeps its fields mounted but hidden, and a hidden field\n *    cannot be scrolled to or focused. When a panel had to be shown, the scroll waits for it to render.\n * 4. Scroll it into view (centered, smooth) and focus the first focusable\n *    control inside it, so keyboard users land where the repair happens.\n *\n * The `[name=\"...\"]` fallback covers controls rendered outside a chrome wrapper.\n */\n\nimport type { FieldErrors } from 'react-hook-form';\nimport { FormContextUtils } from '../form-context.utils';\nimport { requestFieldReveal, whenRendered } from './field-reveal';\n\n/**\n * The attribute the form error summary carries, so the scroll can reach it when the error belongs to no field.\n */\nexport const FORM_ERROR_SUMMARY_ATTRIBUTE = 'data-form-error-summary';\n\n/**\n * Flatten a react-hook-form `FieldErrors` tree into dotted field paths.\n *\n * An error LEAF is any node carrying a string `message` or a string `type`\n * (the shape both the standard-schema resolver and `setError` produce). Array\n * `root` errors are attributed to the array path itself (`checklist.root` →\n * `checklist`). Order follows the error object's own insertion order — DOM\n * ordering is applied later by {@link scrollAndFocusFirstErroredField}.\n */\nexport function collectErroredFieldPaths(errors: FieldErrors | Record<string, unknown>): string[] {\n  const paths: string[] = [];\n\n  const walk = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object') return;\n    const record = node as Record<string, unknown>;\n\n    // Error leaf: RHF error objects carry `type` (string) and usually `message`.\n    if (typeof record.message === 'string' || typeof record.type === 'string') {\n      if (path) paths.push(path);\n      return;\n    }\n\n    for (const [key, value] of Object.entries(record)) {\n      if (key === 'root') {\n        // Array/object root errors belong to the container path itself.\n        walk(value, path);\n        continue;\n      }\n      walk(value, path ? `${path}.${key}` : key);\n    }\n  };\n\n  walk(errors, '');\n  return paths;\n}\n\nfunction escapeAttributeValue(value: string): string {\n  // CSS.escape is available in every supported browser; fall back to a\n  // conservative quote/backslash escape for non-DOM test environments.\n  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n    return CSS.escape(value);\n  }\n  return value.replace(/[\"\\\\]/g, '\\\\$&');\n}\n\n/**\n * Scroll the first errored field (in DOM order) into view and focus it.\n *\n * @param erroredPaths dotted field paths, e.g. from {@link collectErroredFieldPaths}\n *   or `Object.keys(serverValidationErrors)`.\n * @returns `true` when a matching element was found and scrolled.\n */\nexport function scrollAndFocusFirstErroredField(erroredPaths: string[]): boolean {\n  if (typeof document === 'undefined' || erroredPaths.length === 0) return false;\n\n  const pathSet = new Set(erroredPaths);\n  let target: HTMLElement | null = null;\n\n  // DOM order is the authoritative \"first\" — the error map's key order is not.\n  const chromeElements = document.querySelectorAll<HTMLElement>('[data-field]');\n  for (const element of chromeElements) {\n    const dataField = element.getAttribute('data-field');\n    if (!dataField) continue;\n    if (pathSet.has(dataField) || erroredPaths.some((path) => path.startsWith(`${dataField}.`))) {\n      target = element;\n      break;\n    }\n  }\n\n  // Fallback: controls registered by name without a chrome wrapper.\n  if (!target) {\n    for (const path of erroredPaths) {\n      const byName = document.querySelector<HTMLElement>(`[name=\"${escapeAttributeValue(path)}\"]`);\n      if (byName) {\n        target = byName;\n        break;\n      }\n    }\n  }\n\n  if (!target) {\n    // An error that names no field (a rule across fields, a refusal of the whole record) has nothing to scroll to, so\n    // the click on Save moved nothing. The summary lists it: bring the summary on screen and focus it, as the error\n    // summary pattern does. It renders with the errors, so it may not be in the DOM yet.\n    if (erroredPaths.some((path) => FormContextUtils.isFormLevelErrorPath(path))) {\n      focusFormErrorSummaryWhenRendered();\n      return true;\n    }\n    return false;\n  }\n\n  const revealedTarget = target;\n  if (requestFieldReveal(revealedTarget)) whenRendered(revealedTarget, () => scrollAndFocus(revealedTarget));\n  else scrollAndFocus(revealedTarget);\n  return true;\n}\n\n/** Scrolls the first form error summary on the page into view and focuses it, polling a few frames for it to render. */\nfunction focusFormErrorSummaryWhenRendered(maxFrames = 20): void {\n  const schedule = typeof requestAnimationFrame === 'function' ? requestAnimationFrame : (step: () => void) => setTimeout(step, 16);\n  let frames = 0;\n  const step = (): void => {\n    const summary = document.querySelector<HTMLElement>(`[${FORM_ERROR_SUMMARY_ATTRIBUTE}]`);\n    if (summary) {\n      summary.scrollIntoView({ behavior: 'smooth', block: 'center' });\n      summary.focus({ preventScroll: true });\n      return;\n    }\n    if (frames < maxFrames) {\n      frames += 1;\n      schedule(step);\n    }\n  };\n  step();\n}\n\n/** Scrolls `target` to the centre of the viewport and focuses its first focusable control. */\nfunction scrollAndFocus(target: HTMLElement): void {\n  target.scrollIntoView({ behavior: 'smooth', block: 'center' });\n\n  // Focus after the smooth scroll has started; `preventScroll` keeps the focus\n  // jump from fighting the centered smooth scroll already in flight.\n  const focusTarget = target;\n  setTimeout(() => {\n    if (!document.body.contains(focusTarget)) return;\n    const focusable = focusTarget.matches('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])')\n      ? focusTarget\n      : focusTarget.querySelector<HTMLElement>('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])');\n    if (focusable && document.body.contains(focusable)) {\n      try {\n        focusable.focus({ preventScroll: true });\n      } catch {\n        focusable.focus();\n      }\n    }\n  }, 100);\n}\n"]}

package/dist/esm/components/form/validation-errors/useServerErrorInjection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useServerErrorInjection.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,UAAU,6BAA6B;IACrC;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjE;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAClD,6BAA6B,CA4D/B"}
+{"version":3,"file":"useServerErrorInjection.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C,UAAU,6BAA6B;IACrC;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjE;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAClD,6BAA6B,CAgE/B"}

package/dist/esm/components/form/validation-errors/useServerErrorInjection.js

@@ -1,6 +1,7 @@
 import { useRef, useCallback, useEffect } from 'react';
 import { isValidationErrorEntry } from '@wildo-ai/saas-models';
-import { SERVER_ERROR_TYPE } from '../form-context.js';
+import { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE } from '../form-context.js';
+import { FormContextUtils } from '../form-context.utils.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
 import { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils.js';
 /**
@@ -86,7 +87,11 @@ export function useServerErrorInjection(formMethodsRef) {
     }, [formMethodsRef]);
     const injectServerErrors = useCallback((validationErrors) => {
         if (formMethodsRef.current) {
-            Object.entries(validationErrors).forEach(([fieldName, value]) => {
+            Object.entries(validationErrors).forEach(([key, value]) => {
+                // A refusal that names no field (an empty key, `root`, `_`) is filed under the ONE form-level key the summary
+                // lists. Kept as sent, an empty key was worse than misfiled: `clearErrors('')` clears EVERY error of the form,
+                // because react-hook-form reads an empty name as "no name", and `root` is the key `handleSubmit` deletes.
+                const fieldName = FormContextUtils.isFormLevelErrorPath(key) ? FORM_LEVEL_ERROR_PATH : key;
                 // A coded entry carries no words on purpose: the server sends `not_unique`, the catalog says what that
                 // means in this person's language. A plain string is a message the schema already produced.
                 const message = isValidationErrorEntry(value)
@@ -105,7 +110,7 @@ export function useServerErrorInjection(formMethodsRef) {
             // keeps every server-validation path — direct submit, RMM mutation
             // result, draft save, publish, auth presets — covered by construction.
             // No-ops when no matching `[data-field]`/`[name]` element exists.
-            scrollAndFocusFirstErroredField(Object.keys(validationErrors));
+            scrollAndFocusFirstErroredField(Object.keys(validationErrors).map((key) => (FormContextUtils.isFormLevelErrorPath(key) ? FORM_LEVEL_ERROR_PATH : key)));
         }
     }, [formMethodsRef, tErrorValidation]);
     return { initAutoClearing, injectServerErrors, clearServerErrors };

package/dist/esm/components/form/validation-errors/useServerErrorInjection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useServerErrorInjection.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useRef, useCallback, useEffect } from 'react';\nimport { isValidationErrorEntry, type ValidationErrors } from '@wildo-ai/saas-models';\nimport { type FormMethods } from '../Form';\nimport { SERVER_ERROR_TYPE } from '../form-context';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils';\n\ninterface UseServerErrorInjectionReturn {\n  /**\n   * Start watching form values to auto-clear server errors when the user edits\n   * an errored field. Call once when formMethods become available (typically\n   * from the `onFormReady` callback of `<AutomatedForm>`).\n   *\n   * Safe to call multiple times — previous subscriptions are torn down first.\n   */\n  initAutoClearing: (formMethods: FormMethods) => void;\n  /**\n   * Inject server validation errors onto individual form fields via RHF's\n   * `setError`. Each field is tracked so it can be auto-cleared on edit.\n   * Typically called in a `catch` block after `extractServerValidationErrors()`.\n   *\n   * A value is either a message the schema produced, or a CODED entry — which is resolved here, through the\n   * `errors_validation` catalog, because this is the layer that holds both the catalog and the person's\n   * language (#1180).\n   */\n  injectServerErrors: (validationErrors: ValidationErrors) => void;\n  /**\n   * Clear all currently tracked server errors from the form.\n   * Call at the start of every submit handler (before the `try` block)\n   * so stale server errors don't persist across submissions.\n   */\n  clearServerErrors: () => void;\n}\n\n/**\n * Manages the lifecycle of server-side validation errors injected into\n * React Hook Form fields. Solves the UX problem where server errors\n * (e.g. \"Email already registered\") stick on a field after the user edits\n * it, only disappearing on re-submit.\n *\n * The hook owns a `Set<string>` of field names that currently carry a\n * server error, and a `watch()` subscription that clears those errors\n * the moment the user types in the field — providing instant feedback.\n *\n * **Lifecycle (3 parts):**\n * 1. **Inject** — after a failed submit, call `injectServerErrors()` to\n *    set `{ type: 'server', message }` on each field and register it for\n *    auto-clearing.\n * 2. **Auto-clear** — a `formMethods.watch()` subscription detects edits\n *    on tracked fields and clears the error + removes the field from the set.\n * 3. **Bulk clear** — `clearServerErrors()` removes all tracked errors at\n *    once (call before re-submit to avoid stale errors).\n *\n * Only errors with `type: SERVER_ERROR_TYPE` are tracked. Client-side\n * Zod/RHF validation errors are never affected.\n *\n * The hook does **not** own the `formMethodsRef` — it receives it. This\n * keeps the `<AutomatedForm>` / `onFormReady` callback contract unchanged.\n *\n * @example\n * ```tsx\n * const formMethodsRef = useRef<FormMethods | null>(null);\n * const { initAutoClearing, injectServerErrors, clearServerErrors } =\n *   useServerErrorInjection(formMethodsRef);\n *\n * const handleFormReady = useCallback((formMethods: FormMethods) => {\n *   formMethodsRef.current = formMethods;\n *   initAutoClearing(formMethods);\n * }, [initAutoClearing]);\n *\n * const handleSubmit = async (data: FormData) => {\n *   clearServerErrors();\n *   try {\n *     await submitToServer(data);\n *   } catch (e) {\n *     const errors = extractServerValidationErrors(e);\n *     if (errors) injectServerErrors(errors.validationErrors);\n *   }\n * };\n *\n * return (\n *   <AutomatedForm onFormReady={handleFormReady} onSubmit={handleSubmit} ... />\n * );\n * ```\n *\n * Used by `ResourceAutomatedForm` and auth public-page presets\n * (`UserRegister`, `UserPasswordLost`).\n */\nexport function useServerErrorInjection(\n  formMethodsRef: React.RefObject<FormMethods | null>,\n): UseServerErrorInjectionReturn {\n  const { tErrorValidation } = useI18n();\n\n  const serverErrorFieldsRef = useRef<Set<string>>(new Set());\n  const watchSubscriptionRef = useRef<{ unsubscribe: () => void } | null>(null);\n\n  useEffect(() => {\n    return () => {\n      watchSubscriptionRef.current?.unsubscribe();\n    };\n  }, []);\n\n  const initAutoClearing = useCallback((formMethods: FormMethods) => {\n    watchSubscriptionRef.current?.unsubscribe();\n\n    const subscription = formMethods.watch((_value, { name }) => {\n      if (name && serverErrorFieldsRef.current.has(name)) {\n        formMethods.clearErrors(name);\n        serverErrorFieldsRef.current.delete(name);\n      }\n    });\n\n    watchSubscriptionRef.current = subscription;\n  }, []);\n\n  const clearServerErrors = useCallback(() => {\n    if (formMethodsRef.current && serverErrorFieldsRef.current.size > 0) {\n      Array.from(serverErrorFieldsRef.current).forEach(fieldName => {\n        formMethodsRef.current!.clearErrors(fieldName);\n      });\n      serverErrorFieldsRef.current.clear();\n    }\n  }, [formMethodsRef]);\n\n  const injectServerErrors = useCallback((validationErrors: ValidationErrors) => {\n    if (formMethodsRef.current) {\n      Object.entries(validationErrors).forEach(([fieldName, value]) => {\n        // A coded entry carries no words on purpose: the server sends `not_unique`, the catalog says what that\n        // means in this person's language. A plain string is a message the schema already produced.\n        const message = isValidationErrorEntry(value)\n          ? tErrorValidation(value.code, 'msg', value.params)\n          : value;\n        formMethodsRef.current!.setError(fieldName, {\n          type: SERVER_ERROR_TYPE,\n          message,\n        });\n        serverErrorFieldsRef.current.add(fieldName);\n      });\n      // Bring the first rejected field into view (audit D4). Injection happens\n      // after a submit gesture, so the viewport is typically parked at the\n      // submit button while the errored fields sit off-screen. Placing the\n      // scroll HERE (the single injection seam) instead of at each catch block\n      // keeps every server-validation path — direct submit, RMM mutation\n      // result, draft save, publish, auth presets — covered by construction.\n      // No-ops when no matching `[data-field]`/`[name]` element exists.\n      scrollAndFocusFirstErroredField(Object.keys(validationErrors));\n    }\n  }, [formMethodsRef, tErrorValidation]);\n\n  return { initAutoClearing, injectServerErrors, clearServerErrors };\n}\n"]}
+{"version":3,"file":"useServerErrorInjection.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useRef, useCallback, useEffect } from 'react';\nimport { isValidationErrorEntry, type ValidationErrors } from '@wildo-ai/saas-models';\nimport { type FormMethods } from '../Form';\nimport { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE } from '../form-context';\nimport { FormContextUtils } from '../form-context.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils';\n\ninterface UseServerErrorInjectionReturn {\n  /**\n   * Start watching form values to auto-clear server errors when the user edits\n   * an errored field. Call once when formMethods become available (typically\n   * from the `onFormReady` callback of `<AutomatedForm>`).\n   *\n   * Safe to call multiple times — previous subscriptions are torn down first.\n   */\n  initAutoClearing: (formMethods: FormMethods) => void;\n  /**\n   * Inject server validation errors onto individual form fields via RHF's\n   * `setError`. Each field is tracked so it can be auto-cleared on edit.\n   * Typically called in a `catch` block after `extractServerValidationErrors()`.\n   *\n   * A value is either a message the schema produced, or a CODED entry — which is resolved here, through the\n   * `errors_validation` catalog, because this is the layer that holds both the catalog and the person's\n   * language (#1180).\n   */\n  injectServerErrors: (validationErrors: ValidationErrors) => void;\n  /**\n   * Clear all currently tracked server errors from the form.\n   * Call at the start of every submit handler (before the `try` block)\n   * so stale server errors don't persist across submissions.\n   */\n  clearServerErrors: () => void;\n}\n\n/**\n * Manages the lifecycle of server-side validation errors injected into\n * React Hook Form fields. Solves the UX problem where server errors\n * (e.g. \"Email already registered\") stick on a field after the user edits\n * it, only disappearing on re-submit.\n *\n * The hook owns a `Set<string>` of field names that currently carry a\n * server error, and a `watch()` subscription that clears those errors\n * the moment the user types in the field — providing instant feedback.\n *\n * **Lifecycle (3 parts):**\n * 1. **Inject** — after a failed submit, call `injectServerErrors()` to\n *    set `{ type: 'server', message }` on each field and register it for\n *    auto-clearing.\n * 2. **Auto-clear** — a `formMethods.watch()` subscription detects edits\n *    on tracked fields and clears the error + removes the field from the set.\n * 3. **Bulk clear** — `clearServerErrors()` removes all tracked errors at\n *    once (call before re-submit to avoid stale errors).\n *\n * Only errors with `type: SERVER_ERROR_TYPE` are tracked. Client-side\n * Zod/RHF validation errors are never affected.\n *\n * The hook does **not** own the `formMethodsRef` — it receives it. This\n * keeps the `<AutomatedForm>` / `onFormReady` callback contract unchanged.\n *\n * @example\n * ```tsx\n * const formMethodsRef = useRef<FormMethods | null>(null);\n * const { initAutoClearing, injectServerErrors, clearServerErrors } =\n *   useServerErrorInjection(formMethodsRef);\n *\n * const handleFormReady = useCallback((formMethods: FormMethods) => {\n *   formMethodsRef.current = formMethods;\n *   initAutoClearing(formMethods);\n * }, [initAutoClearing]);\n *\n * const handleSubmit = async (data: FormData) => {\n *   clearServerErrors();\n *   try {\n *     await submitToServer(data);\n *   } catch (e) {\n *     const errors = extractServerValidationErrors(e);\n *     if (errors) injectServerErrors(errors.validationErrors);\n *   }\n * };\n *\n * return (\n *   <AutomatedForm onFormReady={handleFormReady} onSubmit={handleSubmit} ... />\n * );\n * ```\n *\n * Used by `ResourceAutomatedForm` and auth public-page presets\n * (`UserRegister`, `UserPasswordLost`).\n */\nexport function useServerErrorInjection(\n  formMethodsRef: React.RefObject<FormMethods | null>,\n): UseServerErrorInjectionReturn {\n  const { tErrorValidation } = useI18n();\n\n  const serverErrorFieldsRef = useRef<Set<string>>(new Set());\n  const watchSubscriptionRef = useRef<{ unsubscribe: () => void } | null>(null);\n\n  useEffect(() => {\n    return () => {\n      watchSubscriptionRef.current?.unsubscribe();\n    };\n  }, []);\n\n  const initAutoClearing = useCallback((formMethods: FormMethods) => {\n    watchSubscriptionRef.current?.unsubscribe();\n\n    const subscription = formMethods.watch((_value, { name }) => {\n      if (name && serverErrorFieldsRef.current.has(name)) {\n        formMethods.clearErrors(name);\n        serverErrorFieldsRef.current.delete(name);\n      }\n    });\n\n    watchSubscriptionRef.current = subscription;\n  }, []);\n\n  const clearServerErrors = useCallback(() => {\n    if (formMethodsRef.current && serverErrorFieldsRef.current.size > 0) {\n      Array.from(serverErrorFieldsRef.current).forEach(fieldName => {\n        formMethodsRef.current!.clearErrors(fieldName);\n      });\n      serverErrorFieldsRef.current.clear();\n    }\n  }, [formMethodsRef]);\n\n  const injectServerErrors = useCallback((validationErrors: ValidationErrors) => {\n    if (formMethodsRef.current) {\n      Object.entries(validationErrors).forEach(([key, value]) => {\n        // A refusal that names no field (an empty key, `root`, `_`) is filed under the ONE form-level key the summary\n        // lists. Kept as sent, an empty key was worse than misfiled: `clearErrors('')` clears EVERY error of the form,\n        // because react-hook-form reads an empty name as \"no name\", and `root` is the key `handleSubmit` deletes.\n        const fieldName = FormContextUtils.isFormLevelErrorPath(key) ? FORM_LEVEL_ERROR_PATH : key;\n        // A coded entry carries no words on purpose: the server sends `not_unique`, the catalog says what that\n        // means in this person's language. A plain string is a message the schema already produced.\n        const message = isValidationErrorEntry(value)\n          ? tErrorValidation(value.code, 'msg', value.params)\n          : value;\n        formMethodsRef.current!.setError(fieldName, {\n          type: SERVER_ERROR_TYPE,\n          message,\n        });\n        serverErrorFieldsRef.current.add(fieldName);\n      });\n      // Bring the first rejected field into view (audit D4). Injection happens\n      // after a submit gesture, so the viewport is typically parked at the\n      // submit button while the errored fields sit off-screen. Placing the\n      // scroll HERE (the single injection seam) instead of at each catch block\n      // keeps every server-validation path — direct submit, RMM mutation\n      // result, draft save, publish, auth presets — covered by construction.\n      // No-ops when no matching `[data-field]`/`[name]` element exists.\n      scrollAndFocusFirstErroredField(Object.keys(validationErrors).map((key) => (FormContextUtils.isFormLevelErrorPath(key) ? FORM_LEVEL_ERROR_PATH : key)));\n    }\n  }, [formMethodsRef, tErrorValidation]);\n\n  return { initAutoClearing, injectServerErrors, clearServerErrors };\n}\n"]}

package/dist/esm/components/form/validation-errors/validate-fields-and-show-errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Validating PART of a form and showing what is wrong with it: what a section's Save and a wizard's Next both do
+ * before they act on some of a form's fields.
+ *
+ * Both used to call `form.trigger(names)` and, when it failed, stop. Three things went wrong between those two lines:
+ *
+ * 1. **The errors stayed invisible.** A field shows a CLIENT error once it is touched or the form has been submitted
+ *    (`getFieldError`). In the default blur mode, the fields a person never visited are neither, so Save or Next did
+ *    nothing visible at all. The fields that failed are now marked touched, and the first one is scrolled to (and its
+ *    hidden panel shown, `field-reveal.ts`). A server error shows whatever the touch state, and its field is NOT
+ *    touched: touching writes the value back, and the server-error auto-clear reads any write as an edit.
+ * 2. **A server's refusal was erased.** `trigger` re-runs the CLIENT schema at those names and replaces their errors,
+ *    so a uniqueness conflict or a rejection the server returned, which no client schema can know about, vanished,
+ *    and Next let the person past a value the server had just refused. Those errors are put back, and still count.
+ *    (They clear on their own once the person edits the field: `useServerErrorInjection`.)
+ * 3. **An empty list validated the whole form.** `trigger()` with no names means EVERY field, so a step with no
+ *    fields of its own failed on fields from other steps and could never be left. No fields means nothing to check.
+ *
+ * What is touched is each field IN error (an array item's `steps.0.title`), not the name the section registered
+ * (`steps`). Touching a field array's root went through `setValue`, which for a field array ignores `shouldTouch` and
+ * republishes the array, so every row was given a new key and remounted, and the items stayed untouched with their
+ * errors hidden (react-hook-form 7.71, `createFormControl` `setValue`). A field array's own error (too few items) is
+ * shown whatever the touch state, so its root is never touched.
+ */
+import type { FieldValues, UseFormReturn } from 'react-hook-form';
+/**
+ * Validates the named fields, and when any is invalid makes the errors visible and brings the first one on screen.
+ *
+ * @returns whether the named fields are valid, counting a server error still standing on one of them.
+ */
+export declare function validateFieldsAndShowErrors<TValues extends FieldValues>(form: UseFormReturn<TValues>, fieldNames: readonly string[]): Promise<boolean>;
+//# sourceMappingURL=validate-fields-and-show-errors.d.ts.map

package/dist/esm/components/form/validation-errors/validate-fields-and-show-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-fields-and-show-errors.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/validate-fields-and-show-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAc,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA+B9E;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,SAAS,WAAW,EAC3E,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

package/dist/esm/components/form/validation-errors/validate-fields-and-show-errors.js

@@ -0,0 +1,60 @@
+import { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from '../form-context.js';
+import { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils.js';
+/** Every error leaf under `node`, with its dotted path. A leaf carries a string `type` or `message`; `ref` is never walked. */
+function collectErrorLeaves(node, path, leaves) {
+    if (!node || typeof node !== 'object')
+        return;
+    const record = node;
+    if (typeof record.type === 'string' || typeof record.message === 'string') {
+        leaves.push({ path, error: record });
+        return;
+    }
+    for (const [key, value] of Object.entries(record)) {
+        // An array's or an object's own error sits under `root` and belongs to the container's path.
+        collectErrorLeaves(value, key === 'root' ? path : `${path}.${key}`, leaves);
+    }
+}
+function erroredLeavesOf(form, names) {
+    const leaves = [];
+    for (const name of names)
+        collectErrorLeaves(form.getFieldState(name).error, name, leaves);
+    return leaves;
+}
+const isServerError = (error) => error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;
+/**
+ * Validates the named fields, and when any is invalid makes the errors visible and brings the first one on screen.
+ *
+ * @returns whether the named fields are valid, counting a server error still standing on one of them.
+ */
+export async function validateFieldsAndShowErrors(form, fieldNames) {
+    if (fieldNames.length === 0)
+        return true;
+    const serverErrors = erroredLeavesOf(form, fieldNames).filter((leaf) => isServerError(leaf.error));
+    const clientValid = await form.trigger(fieldNames);
+    for (const { path, error } of serverErrors) {
+        if (!form.getFieldState(path).error)
+            form.setError(path, { type: error.type, message: error.message });
+    }
+    if (clientValid && serverErrors.length === 0)
+        return true;
+    const leaves = erroredLeavesOf(form, fieldNames);
+    const untypedForm = form;
+    const fieldArrayNames = fieldArrayNamesOf(untypedForm);
+    for (const leaf of leaves) {
+        if (isServerError(leaf.error) || fieldArrayNames.has(leaf.path))
+            continue;
+        // Touching is what makes a field show its error (`getFieldError`); the value is written back unchanged.
+        untypedForm.setValue(leaf.path, untypedForm.getValues(leaf.path), { shouldTouch: true, shouldDirty: false, shouldValidate: false });
+    }
+    scrollAndFocusFirstErroredField(leaves.map((leaf) => leaf.path));
+    return false;
+}
+/**
+ * The names `useFieldArray` manages. React Hook Form keeps them on its control and offers no public question for it;
+ * read defensively, an unexpected shape reads as none (the cost is a remount, never a lost value).
+ */
+function fieldArrayNamesOf(form) {
+    const names = form.control._names?.array;
+    return names instanceof Set ? names : new Set();
+}
+//# sourceMappingURL=validate-fields-and-show-errors.js.map

package/dist/esm/components/form/validation-errors/validate-fields-and-show-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-fields-and-show-errors.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/validate-fields-and-show-errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validating PART of a form and showing what is wrong with it: what a section's Save and a wizard's Next both do\n * before they act on some of a form's fields.\n *\n * Both used to call `form.trigger(names)` and, when it failed, stop. Three things went wrong between those two lines:\n *\n * 1. **The errors stayed invisible.** A field shows a CLIENT error once it is touched or the form has been submitted\n *    (`getFieldError`). In the default blur mode, the fields a person never visited are neither, so Save or Next did\n *    nothing visible at all. The fields that failed are now marked touched, and the first one is scrolled to (and its\n *    hidden panel shown, `field-reveal.ts`). A server error shows whatever the touch state, and its field is NOT\n *    touched: touching writes the value back, and the server-error auto-clear reads any write as an edit.\n * 2. **A server's refusal was erased.** `trigger` re-runs the CLIENT schema at those names and replaces their errors,\n *    so a uniqueness conflict or a rejection the server returned, which no client schema can know about, vanished,\n *    and Next let the person past a value the server had just refused. Those errors are put back, and still count.\n *    (They clear on their own once the person edits the field: `useServerErrorInjection`.)\n * 3. **An empty list validated the whole form.** `trigger()` with no names means EVERY field, so a step with no\n *    fields of its own failed on fields from other steps and could never be left. No fields means nothing to check.\n *\n * What is touched is each field IN error (an array item's `steps.0.title`), not the name the section registered\n * (`steps`). Touching a field array's root went through `setValue`, which for a field array ignores `shouldTouch` and\n * republishes the array, so every row was given a new key and remounted, and the items stayed untouched with their\n * errors hidden (react-hook-form 7.71, `createFormControl` `setValue`). A field array's own error (too few items) is\n * shown whatever the touch state, so its root is never touched.\n */\nimport type { FieldError, FieldValues, UseFormReturn } from 'react-hook-form';\nimport { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from '../form-context';\nimport { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils';\n\ninterface ErroredLeaf {\n  path: string;\n  error: FieldError;\n}\n\n/** Every error leaf under `node`, with its dotted path. A leaf carries a string `type` or `message`; `ref` is never walked. */\nfunction collectErrorLeaves(node: unknown, path: string, leaves: ErroredLeaf[]): void {\n  if (!node || typeof node !== 'object') return;\n  const record = node as Record<string, unknown>;\n  if (typeof record.type === 'string' || typeof record.message === 'string') {\n    leaves.push({ path, error: record as unknown as FieldError });\n    return;\n  }\n  for (const [key, value] of Object.entries(record)) {\n    // An array's or an object's own error sits under `root` and belongs to the container's path.\n    collectErrorLeaves(value, key === 'root' ? path : `${path}.${key}`, leaves);\n  }\n}\n\nfunction erroredLeavesOf<TValues extends FieldValues>(form: UseFormReturn<TValues>, names: readonly string[]): ErroredLeaf[] {\n  const leaves: ErroredLeaf[] = [];\n  for (const name of names) collectErrorLeaves(form.getFieldState(name as never).error, name, leaves);\n  return leaves;\n}\n\nconst isServerError = (error: FieldError): boolean => error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;\n\n/**\n * Validates the named fields, and when any is invalid makes the errors visible and brings the first one on screen.\n *\n * @returns whether the named fields are valid, counting a server error still standing on one of them.\n */\nexport async function validateFieldsAndShowErrors<TValues extends FieldValues>(\n  form: UseFormReturn<TValues>,\n  fieldNames: readonly string[],\n): Promise<boolean> {\n  if (fieldNames.length === 0) return true;\n\n  const serverErrors = erroredLeavesOf(form, fieldNames).filter((leaf) => isServerError(leaf.error));\n  const clientValid = await form.trigger(fieldNames as never);\n  for (const { path, error } of serverErrors) {\n    if (!form.getFieldState(path as never).error) form.setError(path as never, { type: error.type, message: error.message });\n  }\n  if (clientValid && serverErrors.length === 0) return true;\n\n  const leaves = erroredLeavesOf(form, fieldNames);\n  const untypedForm = form as unknown as UseFormReturn;\n  const fieldArrayNames = fieldArrayNamesOf(untypedForm);\n  for (const leaf of leaves) {\n    if (isServerError(leaf.error) || fieldArrayNames.has(leaf.path)) continue;\n    // Touching is what makes a field show its error (`getFieldError`); the value is written back unchanged.\n    untypedForm.setValue(leaf.path, untypedForm.getValues(leaf.path), { shouldTouch: true, shouldDirty: false, shouldValidate: false });\n  }\n  scrollAndFocusFirstErroredField(leaves.map((leaf) => leaf.path));\n  return false;\n}\n\n/**\n * The names `useFieldArray` manages. React Hook Form keeps them on its control and offers no public question for it;\n * read defensively, an unexpected shape reads as none (the cost is a remount, never a lost value).\n */\nfunction fieldArrayNamesOf(form: UseFormReturn): ReadonlySet<string> {\n  const names = (form.control as unknown as { _names?: { array?: unknown } })._names?.array;\n  return names instanceof Set ? (names as Set<string>) : new Set();\n}\n"]}

package/dist/esm/components/form/validation-errors/zod-issue-resolver.d.ts

@@ -19,6 +19,10 @@
  *
  * A Standard Schema that is NOT Zod (no `code` on its issues) degrades to exactly what the standard
  * resolver produced: `type: ''` and the message.
+ *
+ * It differs from upstream in one more place: an issue with NO path (a refinement on the whole object) is recorded
+ * under `FORM_LEVEL_ERROR_PATH` instead of being skipped. Skipped, a form whose only failing rule was one of these
+ * read as valid and submitted the empty `values` a failed resolve returns.
  */
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import type { FieldError, FieldValues, Resolver } from 'react-hook-form';
@@ -29,6 +33,12 @@ export interface ZodIssueFieldError extends FieldError {
 }
 /** The issue's fields other than its code, message, path and the raw input (which is never display text). */
 export declare function zodIssueParams(issue: object): Record<string, unknown> | undefined;
+/**
+ * The field errors a list of issues stands for, keyed by dotted path, exactly as this resolver records them: the code
+ * as `type`, the issue's fields as `params`, and an issue with no path under {@link FORM_LEVEL_ERROR_PATH}. For a
+ * caller that validates outside the resolver (the draft save) and must report the same errors the same way.
+ */
+export declare function zodIssuesToFieldErrors(issues: readonly StandardSchemaV1.Issue[]): Record<string, ZodIssueFieldError>;
 /**
  * Creates a react-hook-form resolver for a Zod 4 (Standard Schema) schema that keeps each issue's
  * code as the field error's `type` and its fields as `params`. Drop-in for `standardSchemaResolver`.

package/dist/esm/components/form/validation-errors/zod-issue-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-issue-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/zod-issue-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGzE,wGAAwG;AACxG,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMjF;AAqBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,WAAW,EAAE,OAAO,EAAE,MAAM,EACzE,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EACvC,eAAe,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,CAe1C"}
+{"version":3,"file":"zod-issue-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/zod-issue-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIzE,wGAAwG;AACxG,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMjF;AAsBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAEpH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,WAAW,EAAE,OAAO,EAAE,MAAM,EACzE,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EACvC,eAAe,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,CAe1C"}

package/dist/esm/components/form/validation-errors/zod-issue-resolver.js

@@ -1,4 +1,5 @@
 import { getDotPath } from '@standard-schema/utils';
+import { FORM_LEVEL_ERROR_PATH } from '../form-context.js';
 import { toNestErrors, validateFieldsNatively } from './resolver-error-nesting.js';
 const NON_PARAM_ISSUE_KEYS = new Set(['code', 'message', 'path', 'input']);
 /** The issue's fields other than its code, message, path and the raw input (which is never display text). */
@@ -13,9 +14,9 @@ export function zodIssueParams(issue) {
 function parseErrorSchema(issues, validateAllFieldCriteria) {
     const errors = {};
     for (const issue of issues) {
-        const path = getDotPath(issue);
-        if (!path)
-            continue;
+        // An issue with no path is FORM-level (a refine on the whole object). Skipping it — as upstream does — made a form
+        // whose only issue was one of these read as valid and submit the resolver's empty failure `values`.
+        const path = getDotPath(issue) || FORM_LEVEL_ERROR_PATH;
         const issueCode = issue.code;
         const code = typeof issueCode === 'string' ? issueCode : '';
         if (!errors[path]) {
@@ -29,6 +30,14 @@ function parseErrorSchema(issues, validateAllFieldCriteria) {
     }
     return errors;
 }
+/**
+ * The field errors a list of issues stands for, keyed by dotted path, exactly as this resolver records them: the code
+ * as `type`, the issue's fields as `params`, and an issue with no path under {@link FORM_LEVEL_ERROR_PATH}. For a
+ * caller that validates outside the resolver (the draft save) and must report the same errors the same way.
+ */
+export function zodIssuesToFieldErrors(issues) {
+    return parseErrorSchema(issues, false);
+}
 /**
  * Creates a react-hook-form resolver for a Zod 4 (Standard Schema) schema that keeps each issue's
  * code as the field error's `type` and its fields as `params`. Drop-in for `standardSchemaResolver`.

package/dist/esm/components/form/validation-errors/zod-issue-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod-issue-resolver.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/zod-issue-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The form resolver that keeps a Zod issue's CODE and PARAMS on the field error (issue #995).\n *\n * `standardSchemaResolver` records every issue as `{ message, type: '' }`, so the only thing a field\n * error carried was the schema's own prose — \"Invalid phone number\", \"City is required\", \"Too small:\n * expected string to have >=1 characters\" — in the language the SCHEMA was written in, whatever the\n * reader's locale. `getFieldError` translates through `errors_validation.<code>.msg`, which needs the\n * code; with `type: ''` that catalog was unreachable for every schema issue and the English went\n * straight to the screen (`display-text-comes-from-i18n.md`).\n *\n * Zod 4's Standard Schema `validate` returns Zod's OWN issues — `code`, `path`, `message`, plus the\n * per-code fields (`minimum`, `origin`, `format`, `params`, …) — so nothing is lost until the resolver\n * drops it. This resolver is the standard one with that one difference: `type` is the issue code and\n * the issue's other fields ride along as `params`, exactly the parameters the `errors_validation`\n * catalog is planned with (`LabellingPolicy[ERRORS_VALIDATION]`). Everything else — nesting by path,\n * `criteriaMode: 'all'`, native validation, `raw` values — is the standard resolver's. The nesting and\n * native-validation helpers are upstream's code, ported into `resolver-error-nesting.ts` and held equal to\n * `@hookform/resolvers` by its parity test; that file says why importing them cost more than copying (#2029).\n *\n * A Standard Schema that is NOT Zod (no `code` on its issues) degrades to exactly what the standard\n * resolver produced: `type: ''` and the message.\n */\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { getDotPath } from '@standard-schema/utils';\nimport type { FieldError, FieldValues, Resolver } from 'react-hook-form';\nimport { toNestErrors, validateFieldsNatively } from './resolver-error-nesting';\n\n/** The field error this resolver records: the standard one plus the issue's translatable parameters. */\nexport interface ZodIssueFieldError extends FieldError {\n  /** The issue's fields other than `code`, `message` and `path` — what `errors_validation.<code>.msg` interpolates. */\n  params?: Record<string, unknown>;\n}\n\nconst NON_PARAM_ISSUE_KEYS = new Set(['code', 'message', 'path', 'input']);\n\n/** The issue's fields other than its code, message, path and the raw input (which is never display text). */\nexport function zodIssueParams(issue: object): Record<string, unknown> | undefined {\n  const params: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(issue)) {\n    if (!NON_PARAM_ISSUE_KEYS.has(key)) params[key] = value;\n  }\n  return Object.keys(params).length > 0 ? params : undefined;\n}\n\nfunction parseErrorSchema(issues: readonly StandardSchemaV1.Issue[], validateAllFieldCriteria: boolean): Record<string, ZodIssueFieldError> {\n  const errors: Record<string, ZodIssueFieldError> = {};\n  for (const issue of issues) {\n    const path = getDotPath(issue);\n    if (!path) continue;\n    const issueCode = (issue as { code?: unknown }).code;\n    const code = typeof issueCode === 'string' ? issueCode : '';\n    if (!errors[path]) {\n      const params = zodIssueParams(issue);\n      errors[path] = { message: issue.message, type: code, ...(params ? { params } : {}) };\n    }\n    if (validateAllFieldCriteria) {\n      const types = errors[path].types || {};\n      errors[path].types = { ...types, [code || Object.keys(types).length]: issue.message };\n    }\n  }\n  return errors;\n}\n\n/**\n * Creates a react-hook-form resolver for a Zod 4 (Standard Schema) schema that keeps each issue's\n * code as the field error's `type` and its fields as `params`. Drop-in for `standardSchemaResolver`.\n */\nexport function zodIssueResolver<Input extends FieldValues, Context, Output>(\n  schema: StandardSchemaV1<Input, Output>,\n  resolverOptions: { raw?: boolean } = {},\n): Resolver<Input, Context, Output | Input> {\n  return async (values, _context, options) => {\n    let result = schema['~standard'].validate(values);\n    if (result instanceof Promise) result = await result;\n\n    if (result.issues) {\n      const errors = parseErrorSchema(result.issues, !options.shouldUseNativeValidation && options.criteriaMode === 'all');\n      return { values: {}, errors: toNestErrors(errors, options) };\n    }\n    // Not narrowed by the `issues` check above under this compiler: a success result is the only one left.\n    const parsed = (result as StandardSchemaV1.SuccessResult<Output>).value;\n\n    if (options.shouldUseNativeValidation) validateFieldsNatively({}, options);\n    return { values: resolverOptions.raw ? Object.assign({}, values) : parsed, errors: {} };\n  };\n}\n"]}
+{"version":3,"file":"zod-issue-resolver.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/zod-issue-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The form resolver that keeps a Zod issue's CODE and PARAMS on the field error (issue #995).\n *\n * `standardSchemaResolver` records every issue as `{ message, type: '' }`, so the only thing a field\n * error carried was the schema's own prose — \"Invalid phone number\", \"City is required\", \"Too small:\n * expected string to have >=1 characters\" — in the language the SCHEMA was written in, whatever the\n * reader's locale. `getFieldError` translates through `errors_validation.<code>.msg`, which needs the\n * code; with `type: ''` that catalog was unreachable for every schema issue and the English went\n * straight to the screen (`display-text-comes-from-i18n.md`).\n *\n * Zod 4's Standard Schema `validate` returns Zod's OWN issues — `code`, `path`, `message`, plus the\n * per-code fields (`minimum`, `origin`, `format`, `params`, …) — so nothing is lost until the resolver\n * drops it. This resolver is the standard one with that one difference: `type` is the issue code and\n * the issue's other fields ride along as `params`, exactly the parameters the `errors_validation`\n * catalog is planned with (`LabellingPolicy[ERRORS_VALIDATION]`). Everything else — nesting by path,\n * `criteriaMode: 'all'`, native validation, `raw` values — is the standard resolver's. The nesting and\n * native-validation helpers are upstream's code, ported into `resolver-error-nesting.ts` and held equal to\n * `@hookform/resolvers` by its parity test; that file says why importing them cost more than copying (#2029).\n *\n * A Standard Schema that is NOT Zod (no `code` on its issues) degrades to exactly what the standard\n * resolver produced: `type: ''` and the message.\n *\n * It differs from upstream in one more place: an issue with NO path (a refinement on the whole object) is recorded\n * under `FORM_LEVEL_ERROR_PATH` instead of being skipped. Skipped, a form whose only failing rule was one of these\n * read as valid and submitted the empty `values` a failed resolve returns.\n */\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { getDotPath } from '@standard-schema/utils';\nimport type { FieldError, FieldValues, Resolver } from 'react-hook-form';\nimport { FORM_LEVEL_ERROR_PATH } from '../form-context';\nimport { toNestErrors, validateFieldsNatively } from './resolver-error-nesting';\n\n/** The field error this resolver records: the standard one plus the issue's translatable parameters. */\nexport interface ZodIssueFieldError extends FieldError {\n  /** The issue's fields other than `code`, `message` and `path` — what `errors_validation.<code>.msg` interpolates. */\n  params?: Record<string, unknown>;\n}\n\nconst NON_PARAM_ISSUE_KEYS = new Set(['code', 'message', 'path', 'input']);\n\n/** The issue's fields other than its code, message, path and the raw input (which is never display text). */\nexport function zodIssueParams(issue: object): Record<string, unknown> | undefined {\n  const params: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(issue)) {\n    if (!NON_PARAM_ISSUE_KEYS.has(key)) params[key] = value;\n  }\n  return Object.keys(params).length > 0 ? params : undefined;\n}\n\nfunction parseErrorSchema(issues: readonly StandardSchemaV1.Issue[], validateAllFieldCriteria: boolean): Record<string, ZodIssueFieldError> {\n  const errors: Record<string, ZodIssueFieldError> = {};\n  for (const issue of issues) {\n    // An issue with no path is FORM-level (a refine on the whole object). Skipping it — as upstream does — made a form\n    // whose only issue was one of these read as valid and submit the resolver's empty failure `values`.\n    const path = getDotPath(issue) || FORM_LEVEL_ERROR_PATH;\n    const issueCode = (issue as { code?: unknown }).code;\n    const code = typeof issueCode === 'string' ? issueCode : '';\n    if (!errors[path]) {\n      const params = zodIssueParams(issue);\n      errors[path] = { message: issue.message, type: code, ...(params ? { params } : {}) };\n    }\n    if (validateAllFieldCriteria) {\n      const types = errors[path].types || {};\n      errors[path].types = { ...types, [code || Object.keys(types).length]: issue.message };\n    }\n  }\n  return errors;\n}\n\n/**\n * The field errors a list of issues stands for, keyed by dotted path, exactly as this resolver records them: the code\n * as `type`, the issue's fields as `params`, and an issue with no path under {@link FORM_LEVEL_ERROR_PATH}. For a\n * caller that validates outside the resolver (the draft save) and must report the same errors the same way.\n */\nexport function zodIssuesToFieldErrors(issues: readonly StandardSchemaV1.Issue[]): Record<string, ZodIssueFieldError> {\n  return parseErrorSchema(issues, false);\n}\n\n/**\n * Creates a react-hook-form resolver for a Zod 4 (Standard Schema) schema that keeps each issue's\n * code as the field error's `type` and its fields as `params`. Drop-in for `standardSchemaResolver`.\n */\nexport function zodIssueResolver<Input extends FieldValues, Context, Output>(\n  schema: StandardSchemaV1<Input, Output>,\n  resolverOptions: { raw?: boolean } = {},\n): Resolver<Input, Context, Output | Input> {\n  return async (values, _context, options) => {\n    let result = schema['~standard'].validate(values);\n    if (result instanceof Promise) result = await result;\n\n    if (result.issues) {\n      const errors = parseErrorSchema(result.issues, !options.shouldUseNativeValidation && options.criteriaMode === 'all');\n      return { values: {}, errors: toNestErrors(errors, options) };\n    }\n    // Not narrowed by the `issues` check above under this compiler: a success result is the only one left.\n    const parsed = (result as StandardSchemaV1.SuccessResult<Output>).value;\n\n    if (options.shouldUseNativeValidation) validateFieldsNatively({}, options);\n    return { values: resolverOptions.raw ? Object.assign({}, values) : parsed, errors: {} };\n  };\n}\n"]}

package/dist/esm/components/navigation/app-level/ApplicationLevel_QuickActionButton.d.ts

@@ -1,7 +1,14 @@
 import React from 'react';
 import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+import type { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas';
 export interface ApplicationLevelProps_QuickActionButton {
     placement?: 'floating' | 'fixed';
+    /**
+     * Set when the menubar or the sidebar HOSTS the button: it then renders as one of that chrome's controls rather
+     * than as the floating button. The menubar used to pass this and the preset ignored it, so a quick action hosted
+     * in the menubar still floated in the corner of the content area.
+     */
+    containerType?: ApplicationLevelComponentType;
 }
 export declare function ApplicationLevel_QuickActionButton({ preset, ...props }: ApplicationLevelProps_QuickActionButton & ComponentPresetProps): React.JSX.Element;
 //# sourceMappingURL=ApplicationLevel_QuickActionButton.d.ts.map

package/dist/esm/components/navigation/app-level/ApplicationLevel_QuickActionButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApplicationLevel_QuickActionButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_QuickActionButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAKxH,MAAM,WAAW,uCAAuC;IACtD,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;CAClC;AAED,wBAAgB,kCAAkC,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,uCAAuC,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGpL"}
+{"version":3,"file":"ApplicationLevel_QuickActionButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_QuickActionButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAGxH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAG3H,MAAM,WAAW,uCAAuC;IACtD,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC/C;AAED,wBAAgB,kCAAkC,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,uCAAuC,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGpL"}

package/dist/esm/components/navigation/app-level/ApplicationLevel_QuickActionButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApplicationLevel_QuickActionButton.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_QuickActionButton.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAO7F,MAAM,UAAU,kCAAkC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkE;IAC/J,MAAM,SAAS,GAAG,uBAAuB,CAA0C,qBAAqB,CAAC,qCAAqC,EAAE,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9L,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\n\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\n\n// --- Contract ---\nexport interface ApplicationLevelProps_QuickActionButton {\n  placement?: 'floating' | 'fixed';\n}\n\nexport function ApplicationLevel_QuickActionButton({ preset = CorePresetNames.DEFAULT, ...props }: ApplicationLevelProps_QuickActionButton & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ApplicationLevelProps_QuickActionButton>(FrontendComponentType.APPLICATION_LEVEL_QUICK_ACTION_BUTTON, 'ApplicationLevel_QuickActionButton')(preset);\n  return <Component {...props} />;\n}\n"]}
+{"version":3,"file":"ApplicationLevel_QuickActionButton.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_QuickActionButton.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAc7F,MAAM,UAAU,kCAAkC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkE;IAC/J,MAAM,SAAS,GAAG,uBAAuB,CAA0C,qBAAqB,CAAC,qCAAqC,EAAE,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9L,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\n\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport type { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n// --- Contract ---\nexport interface ApplicationLevelProps_QuickActionButton {\n  placement?: 'floating' | 'fixed';\n  /**\n   * Set when the menubar or the sidebar HOSTS the button: it then renders as one of that chrome's controls rather\n   * than as the floating button. The menubar used to pass this and the preset ignored it, so a quick action hosted\n   * in the menubar still floated in the corner of the content area.\n   */\n  containerType?: ApplicationLevelComponentType;\n}\n\nexport function ApplicationLevel_QuickActionButton({ preset = CorePresetNames.DEFAULT, ...props }: ApplicationLevelProps_QuickActionButton & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ApplicationLevelProps_QuickActionButton>(FrontendComponentType.APPLICATION_LEVEL_QUICK_ACTION_BUTTON, 'ApplicationLevel_QuickActionButton')(preset);\n  return <Component {...props} />;\n}\n"]}

package/dist/esm/components/navigation/app-level/ApplicationLevel_UtilityPanel.d.ts

@@ -3,11 +3,17 @@ import { ComponentPresetProps } from '../../../core/components-registry/componen
 import type { UtilityPanelPlacement } from '../../../core/app-shell/app-shell.schemas';
 import type { BaseApplicationLevelProps } from './component-props.application-level.frontend.schemas';
 import type { UtilityPanelItem } from '../../../core/config/launcher-items.frontend.schemas';
+import type { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas';
 export interface ApplicationLevelProps_UtilityPanel extends BaseApplicationLevelProps {
     /** Horizontal position of the utility panel. Defaults to END (right side). */
     position?: UtilityPanelPlacement;
     /** Items to display in the utility panel. */
     items?: UtilityPanelItem[];
+    /**
+     * Set when the menubar or the sidebar HOSTS the panel's trigger (`UTILITY_PANEL` in its `hostedComponents`): the
+     * trigger is then one control of that chrome's cluster rather than standing alone at the shell edge.
+     */
+    containerType?: ApplicationLevelComponentType;
 }
 export declare function ApplicationLevel_UtilityPanel({ preset, ...props }: ApplicationLevelProps_UtilityPanel & ComponentPresetProps): React.JSX.Element;
 //# sourceMappingURL=ApplicationLevel_UtilityPanel.d.ts.map

package/dist/esm/components/navigation/app-level/ApplicationLevel_UtilityPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApplicationLevel_UtilityPanel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAGxH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iEAAiE,CAAC;AAGxG,MAAM,WAAW,kCAAmC,SAAQ,yBAAyB;IACnF,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAGD,wBAAgB,6BAA6B,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kCAAkC,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1K"}
+{"version":3,"file":"ApplicationLevel_UtilityPanel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAGxH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iEAAiE,CAAC;AACxG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAG3H,MAAM,WAAW,kCAAmC,SAAQ,yBAAyB;IACnF,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC/C;AAGD,wBAAgB,6BAA6B,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kCAAkC,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1K"}

package/dist/esm/components/navigation/app-level/ApplicationLevel_UtilityPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApplicationLevel_UtilityPanel.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAc7F,MAAM,UAAU,6BAA6B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6D;IACrJ,MAAM,SAAS,GAAG,uBAAuB,CAAqC,qBAAqB,CAAC,+BAA+B,EAAE,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9K,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport type { UtilityPanelPlacement } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport type { BaseApplicationLevelProps } from './component-props.application-level.frontend.schemas';\nimport type { UtilityPanelItem } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n// --- Contract ---\nexport interface ApplicationLevelProps_UtilityPanel extends BaseApplicationLevelProps {\n  /** Horizontal position of the utility panel. Defaults to END (right side). */\n  position?: UtilityPanelPlacement;\n  /** Items to display in the utility panel. */\n  items?: UtilityPanelItem[];\n}\n\n\nexport function ApplicationLevel_UtilityPanel({ preset = CorePresetNames.DEFAULT, ...props }: ApplicationLevelProps_UtilityPanel & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ApplicationLevelProps_UtilityPanel>(FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL, 'ApplicationLevel_UtilityPanel')(preset);\n  return <Component {...props} />;\n}\n"]}
+{"version":3,"file":"ApplicationLevel_UtilityPanel.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAoB7F,MAAM,UAAU,6BAA6B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6D;IACrJ,MAAM,SAAS,GAAG,uBAAuB,CAAqC,qBAAqB,CAAC,+BAA+B,EAAE,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9K,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport type { UtilityPanelPlacement } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport type { BaseApplicationLevelProps } from './component-props.application-level.frontend.schemas';\nimport type { UtilityPanelItem } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n// --- Contract ---\nexport interface ApplicationLevelProps_UtilityPanel extends BaseApplicationLevelProps {\n  /** Horizontal position of the utility panel. Defaults to END (right side). */\n  position?: UtilityPanelPlacement;\n  /** Items to display in the utility panel. */\n  items?: UtilityPanelItem[];\n  /**\n   * Set when the menubar or the sidebar HOSTS the panel's trigger (`UTILITY_PANEL` in its `hostedComponents`): the\n   * trigger is then one control of that chrome's cluster rather than standing alone at the shell edge.\n   */\n  containerType?: ApplicationLevelComponentType;\n}\n\n\nexport function ApplicationLevel_UtilityPanel({ preset = CorePresetNames.DEFAULT, ...props }: ApplicationLevelProps_UtilityPanel & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ApplicationLevelProps_UtilityPanel>(FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL, 'ApplicationLevel_UtilityPanel')(preset);\n  return <Component {...props} />;\n}\n"]}

package/dist/esm/components/navigation/app-level/SidebarResourceBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarResourceBrowser.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/SidebarResourceBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAsBjF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAqDnH,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAChE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA+TxE,CAAC"}
+{"version":3,"file":"SidebarResourceBrowser.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/SidebarResourceBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAsBjF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAmBnH,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAChE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAoUxE,CAAC"}

package/dist/esm/components/navigation/app-level/SidebarResourceBrowser.js

@@ -34,33 +34,13 @@ import { IconCategory, IconSize } from '../../../core/icons/icon-registry.fronte
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 import { useUserFacingErrorMessage } from '../../../core/errors/useUserFacingErrorMessage.js';
 import { LoadingGate } from '../../../core/loading/LoadingGate.js';
+import { cn } from '../../../core/ui/cn.js';
+import { focusIndicatorClasses, FocusIndicatorShape } from '../../../core/ui/themes/focus-indicator.js';
+import { resolveSidebarResourceBrowserOperation } from '../../../core/navigation/sidebar-resource-browser-operation.js';
 import { buildResourceLoadingScope } from '../../../core/loading/loading-scope.frontend.utils.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('sidebar-resource-browser');
 logger.setDebugTypeLogging('sidebar-resource-browser', false);
-function resolveOperation(resourceConfig, operationIdentifier, variantKey) {
-    const matchingOperations = resourceConfig.operations.filter((operation) => (operation.operationIdentifier === operationIdentifier
-        && (variantKey === undefined || operation.variantKey === variantKey)));
-    if (matchingOperations.length === 1) {
-        return matchingOperations[0];
-    }
-    const defaultNonBulkOperations = matchingOperations.filter((operation) => operation.isOperationDefault === true && operation.isBulkOperation !== true);
-    if (variantKey === undefined && defaultNonBulkOperations.length === 1) {
-        return defaultNonBulkOperations[0];
-    }
-    logDebug('Unable to resolve sidebar resource operation unambiguously', {
-        resourceType: resourceConfig.resourceIdentifier,
-        operationIdentifier,
-        variantKey,
-        candidates: matchingOperations.map((candidate) => ({
-            variantType: candidate.variantType,
-            variantKey: candidate.variantKey,
-            isOperationDefault: candidate.isOperationDefault,
-            isBulkOperation: candidate.isBulkOperation,
-        })),
-    });
-    return undefined;
-}
 /** Both bundles this browser reads: its own words, and the generic list's `noItems` empty-state default. */
 const SIDEBAR_RESOURCE_BROWSER_LABEL_COMPONENTS = [
     FrontendComponentType.APPLICATION_LEVEL_SIDEBAR,
@@ -89,18 +69,18 @@ export const SidebarResourceBrowser = ({ resourceType, operation, operationVaria
     const boundOperation = useMemo(() => {
         if (!resourceConfig)
             return undefined;
-        return resolveOperation(resourceConfig, operation ?? CoreResourceOperation.LIST, operationVariant);
+        return resolveSidebarResourceBrowserOperation(resourceConfig, operation ?? CoreResourceOperation.LIST, operationVariant);
     }, [resourceConfig, operation, operationVariant]);
     const navigationOperationResolved = useMemo(() => {
         if (!resourceConfig)
             return undefined;
         if (navigateOperation) {
-            return resolveOperation(resourceConfig, navigateOperation, navigateOperationVariant);
+            return resolveSidebarResourceBrowserOperation(resourceConfig, navigateOperation, navigateOperationVariant);
         }
         if (operation && operation !== CoreResourceOperation.LIST) {
-            return resolveOperation(resourceConfig, operation, operationVariant);
+            return resolveSidebarResourceBrowserOperation(resourceConfig, operation, operationVariant);
         }
-        return (resolveOperation(resourceConfig, CoreResourceOperation.READ) ??
+        return (resolveSidebarResourceBrowserOperation(resourceConfig, CoreResourceOperation.READ) ??
             boundOperation);
     }, [resourceConfig, navigateOperation, navigateOperationVariant, operation, operationVariant, boundOperation]);
     const scopedContextIdentifiers = useMemo(() => {
@@ -287,7 +267,10 @@ export const SidebarResourceBrowser = ({ resourceType, operation, operationVaria
                 const label = getInstanceLabel(instance);
                 const instanceId = (instance.id ?? instance._id ?? idx);
                 const instanceKey = instance.id ?? instance._id ?? `sidebar-resource-${idx}`;
-                return (_jsxs("button", { type: "button", role: "option", onClick: () => handleInstanceClick(instance), className: "w-full text-start px-card-sm py-item-xs text-sm rounded-sm hover:bg-surface-sunken-accent/50 transition-colors flex items-center gap-field-sm min-h-7", children: [_jsx("span", { className: "flex-shrink-0", children: resourceIcon }), _jsx("span", { className: "truncate flex-1", children: label })] }, String(instanceKey)));
+                return (_jsxs("button", { type: "button", role: "option", onClick: () => handleInstanceClick(instance), 
+                    // The INSET focus shape of a packed sidebar item: these rows had no visible focus at all, so a keyboard
+                    // user could not see which instance a press would open.
+                    className: cn('w-full text-start px-card-sm py-item-xs text-sm rounded-sm hover:bg-surface-sunken-accent/50 transition-colors flex items-center gap-field-sm min-h-7', focusIndicatorClasses(FocusIndicatorShape.INSET)), children: [_jsx("span", { className: "flex-shrink-0", children: resourceIcon }), _jsx("span", { className: "truncate flex-1", children: label })] }, String(instanceKey)));
             }) }));
     })();
     return (_jsx(LoadingGate, { i18nKeys: i18nKeys, loadingScopes: loadingScopes, readiness: [{ id: 'sidebar-resource-browser-data', isReady: !isLoading || error !== null }], renderLoading: renderSidebarSkeleton, children: gatedContent }));