@voltro/client 0.52.0 → 0.54.0

package/THIRD-PARTY-NOTICES.md

@@ -5,7 +5,7 @@ property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/client itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (6 packages).
+Generated from the resolved runtime dependency closure (12 packages).
 
 ---
 
@@ -37,6 +37,146 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## @tanstack/devtools-event-client@0.4.4
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2025 TanStack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/form-core@1.33.5
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021-present Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/pacer-lite@0.1.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2025 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/react-store@0.11.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/store@0.11.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## jose@6.2.8
 
 License: MIT
@@ -329,6 +469,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## use-sync-external-store@1.6.0
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## uuid@11.1.1
 
 License: MIT

package/dist/form.d.ts

@@ -1,5 +1,17 @@
+import { ParseResult } from 'effect';
 import { Schema } from 'effect';
 
+/**
+ * Walk a ParseError's issue tree into structured, PATH-PRESERVING issues.
+ * Every leaf keeps its full path (`address.city`, `entries.0.startsAt`) —
+ * nothing collapses to the top-level segment.
+ */
+export declare const decodeFieldIssues: (error: ParseResult.ParseError) => ReadonlyArray<FieldIssue>;
+
+/** The document's locale per the framework contract (`<html lang>`); `'en'`
+ *  outside a browser. Primary subtag only (`de-AT` → `de`). */
+export declare const documentLocale: () => string;
+
 export declare interface FieldDescriptor {
     /** Property name on the input object. */
     readonly name: string;
@@ -16,17 +28,56 @@ export declare interface FieldDescriptor {
     /** The resolved JSON-Schema node — carries `maxLength` / `pattern` /
      *  `minimum` / `format` / `description` for widgets + validation hints. */
     readonly jsonSchema: Readonly<Record<string, unknown>>;
+    /** Dotted parent path for a nested-struct member (`'address'` for
+     *  `address.city`) — the SECTION a renderer groups it under. Top-level
+     *  fields carry none. Overridable via `formField({ section })`. */
+    readonly section?: string;
+    /** Human label for the section (humanised path tail). */
+    readonly sectionLabel?: string;
+    /** Help text — the Schema `description` annotation. */
+    readonly description?: string;
+    /** Declared ordering (`formField({ order })`); fields sort by it, stable
+     *  against declaration order. */
+    readonly order?: number;
+    /** For `widget: 'array'` (array of structs): the ITEM's field descriptors,
+     *  names relative to one item (`startsAt`, not `entries.0.startsAt`). */
+    readonly item?: ReadonlyArray<FieldDescriptor>;
+    /** For `widget: 'reference'`: the referenced TABLE — a renderer binds a
+     *  query-backed picker to it; the VALUE stays the id (or id list). Comes
+     *  from `formField({ reference: 'stores' })`. */
+    readonly reference?: string;
 }
 
 export declare interface FieldErrors {
     readonly [field: string]: string;
 }
 
+/** One structured validation issue. `path` is the dotted field path
+ *  (`'email'`, `'address.city'`, `'entries.0.startsAt'`); `id` is the stable
+ *  message id (`'validation.minLength'`); `params` feed its template;
+ *  `fallback` is a rendered English default so an unknown id still shows a
+ *  sentence, never a bare key. */
+export declare interface FieldIssue {
+    readonly path: string;
+    readonly id: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+    readonly fallback: string;
+}
+
 export declare interface FieldOption {
     readonly value: string;
     readonly label: string;
 }
 
+/** One display section of a form: `name` is the section path (`'address'`),
+ *  `undefined` for the top-level run of unsectioned fields. Contiguous in
+ *  display order, so a renderer can walk sections top to bottom. */
+export declare interface FieldSection {
+    readonly name: string | undefined;
+    readonly label: string | undefined;
+    readonly fields: ReadonlyArray<FieldDescriptor>;
+}
+
 /** DOM id of the JSON script the 422 re-render embeds (survives the
  *  `interactive:'none'` strip — it is neither `type="module"` nor `src`). */
 export declare const FORM_FLASH_SCRIPT_ID = "__voltro_form_flash__";
@@ -68,6 +119,27 @@ export declare const formDataToInput: (schema: Schema.Schema.Any, entries: Itera
  *  uploads are a declared limit of the no-JS path. */
 export declare type FormEntry = readonly [name: string, value: string];
 
+/** UI metadata for one schema field, as an annotations object:
+ *
+ *     Schema.String.annotations(formField({ section: 'contact', order: 2 }))
+ *
+ * Rides the JSON-Schema annotation (merged, not replaced — verified), so it
+ * survives the same normalisation every other descriptor fact does. */
+export declare const formField: (meta: {
+    readonly label?: string;
+    readonly section?: string;
+    readonly order?: number;
+    readonly widget?: WidgetKind;
+    /** Mark the field a REFERENCE to a table: `formField({ reference: 'stores' })`
+     *  → `widget: 'reference'` carrying the target, value = the id (or id
+     *  list, for a multi-reference feeding a target's `relations:`). */
+    readonly reference?: string;
+}) => {
+    readonly jsonSchema: {
+        readonly "x-voltro": typeof meta;
+    };
+};
+
 /**
  * The error/values payload a failed no-JS form POST carries back into the
  * 422 re-render. Keyed by `formKey` so a page with several forms re-fills
@@ -87,6 +159,21 @@ export declare interface FormFlashPayload {
     readonly formError?: string;
 }
 
+/**
+ * Group an ordered field list into contiguous sections — the structure a
+ * form (or its skeleton — the placeholder must have the SHAPE of the real
+ * thing, title rows included) renders. Pure; feeds `<FormSkeleton>`,
+ * `<AutoForm>` layouts and `form.section(...)` alike.
+ */
+export declare const formSections: (fields: ReadonlyArray<FieldDescriptor>) => ReadonlyArray<FieldSection>;
+
+/**
+ * Render one issue id to display text: app resolver first (its `undefined`
+ * falls through), then the built-in catalog for the locale's primary subtag,
+ * then English, then the issue's own fallback sentence.
+ */
+export declare const resolveValidationMessage: (issue: Pick<FieldIssue, "id" | "params" | "fallback">, options?: ValidateOptions) => string;
+
 /**
  * Derive table COLUMNS from a query's output `Schema` — an
  * `Schema.Array(Schema.Struct({...}))`. Drills into the array's element and maps
@@ -103,25 +190,39 @@ export declare const schemaToColumns: (schema: Schema.Schema.Any) => ReadonlyArr
 export declare const schemaToFields: (schema: Schema.Schema.Any) => ReadonlyArray<FieldDescriptor>;
 
 /**
- * Validate `values` against an input `schema`, returning the first error per
- * top-level field (`{ [field]: message }`) — the shape `<AutoForm>` and custom
- * widgets render inline. Uses the same `decodeUnknownEither` + `ArrayFormatter`
- * path the store's `.validate(...)` uses, so client and server speak ONE
- * schema. `{ errors: 'all' }` collects every field's error in one pass.
- *
- * Client-side validation is non-authoritative UX — the server re-validates the
- * same schema on the mutation; this just gives instant inline feedback.
+ * Validate `values` against an input `schema`. Uses the same
+ * `decodeUnknownEither` path the store's `.validate(...)` uses, so client and
+ * server speak ONE schema; `{ errors: 'all' }` collects every field in one
+ * pass. Client-side validation is non-authoritative UX — the server
+ * re-validates the same schema on the mutation.
  */
-export declare const validateFields: (schema: Schema.Schema.Any, values: unknown) => ValidationResult;
+export declare const validateFields: (schema: Schema.Schema.Any, values: unknown, options?: ValidateOptions) => ValidationResult;
+
+export declare interface ValidateOptions {
+    /** BCP-47-ish tag; only the primary subtag is read. Default: the document's
+     *  `<html lang>`, else `'en'`. */
+    readonly locale?: string;
+    readonly messages?: ValidationMessageResolver;
+}
+
+/** Resolve one message id to display text. Return `undefined` to fall through
+ *  to the built-in en/de defaults — so a resolver only has to know the ids it
+ *  overrides. Wire it to `@voltro/i18n` in one line:
+ *  `messages: (id, params) => t(id, params)`. */
+export declare type ValidationMessageResolver = (id: string, params: Readonly<Record<string, unknown>> | undefined, fallback: string) => string | undefined;
 
 export declare interface ValidationResult {
     readonly valid: boolean;
+    /** Display text per field path — what `<AutoForm>` and custom widgets
+     *  render inline. First issue per field wins. */
     readonly errors: FieldErrors;
+    /** Every issue, structured — for widget kits that translate themselves. */
+    readonly issues: ReadonlyArray<FieldIssue>;
 }
 
 /** The default widget kinds the framework can render from a schema. `'custom'`
  *  means "no default widget" — the field needs a render-prop (a nested object,
  *  an array of objects, or a multi-branch union). Mirrors innovation/01's set. */
-export declare type WidgetKind = 'text' | 'textarea' | 'number' | 'checkbox' | 'switch' | 'select' | 'radio' | 'async-select' | 'multi-select' | 'date' | 'datetime' | 'daterange' | 'file' | 'hidden' | 'custom';
+export declare type WidgetKind = 'text' | 'textarea' | 'number' | 'checkbox' | 'switch' | 'select' | 'radio' | 'async-select' | 'multi-select' | 'date' | 'datetime' | 'daterange' | 'file' | 'hidden' | 'array' | 'reference' | 'custom';
 
 export { }

package/dist/form.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./formData-Bw07C0wr.js";
-export { c as FORM_FLASH_SCRIPT_ID, i as FORM_KEY_FIELD, o as FORM_PATH_PREFIX, n as FORM_REDIRECT_FIELD, e as formActionPath, a as formDataToInput, t as schemaToColumns, r as schemaToFields, s as validateFields };
+import { a as e, c as t, d as n, f as r, i, l as a, m as o, n as s, o as c, p as l, r as u, s as d, t as f, u as p } from "./formData-BO7zkG_F.js";
+export { f as FORM_FLASH_SCRIPT_ID, s as FORM_KEY_FIELD, u as FORM_PATH_PREFIX, i as FORM_REDIRECT_FIELD, d as decodeFieldIssues, t as documentLocale, e as formActionPath, c as formDataToInput, n as formField, r as formSections, a as resolveValidationMessage, l as schemaToColumns, o as schemaToFields, p as validateFields };