@voltro/client 0.51.0 → 0.53.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

@@ -0,0 +1,228 @@
+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;
+    /** Human label — the Schema `title` annotation, else the humanised name. */
+    readonly label: string;
+    /** The default widget kind. `'custom'` ⇒ supply a render-prop. */
+    readonly widget: WidgetKind;
+    /** True when the property must be present (in JSON-Schema `required`). */
+    readonly required: boolean;
+    /** True when the value may be `null` (e.g. `Schema.NullOr`). */
+    readonly nullable: boolean;
+    /** Present for closed value sets (a `Schema.Literal` union → `select`). */
+    readonly options?: ReadonlyArray<FieldOption>;
+    /** 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__";
+
+/** Hidden field carrying the form's instance key (multi-form pages). */
+export declare const FORM_KEY_FIELD = "__voltro_form";
+
+/** URL prefix the web listener mounts the no-JS endpoint under. */
+export declare const FORM_PATH_PREFIX = "/form/";
+
+/** Hidden field carrying the declared success-redirect path. */
+export declare const FORM_REDIRECT_FIELD = "__voltro_redirect";
+
+/** The path a native `<AutoForm>` POST goes to. */
+export declare const formActionPath: (mutationTag: string) => string;
+
+/**
+ * Convert posted form entries into the input object the mutation's schema
+ * decodes — the shape `validateFields` (and the RPC payload) expects.
+ *
+ * Mapping rules (the documented contract):
+ * - **checkbox/switch**: present → `true`, absent → `false`. A native POST
+ *   omits an unchecked checkbox entirely, so absence is data, not a gap.
+ * - **number**: `Number(raw)`; `''` → the field is omitted (`undefined`), so
+ *   an optional number stays absent and a required one reports "missing"
+ *   instead of silently becoming `0`.
+ * - **date/datetime**: the string passes through (the schema's encoded side);
+ *   `''` → omitted, same reasoning as number.
+ * - **arrays** (multi-select): `getAll` semantics — every entry under the key,
+ *   items converted per the array's item type (number items → `Number`).
+ * - **unknown keys are dropped**: only names the schema declares are mapped,
+ *   so protocol fields (`__voltro_form`, …) never reach the input object —
+ *   the server rejects undeclared fields, and a hidden bookkeeping field must
+ *   not turn every no-JS submit into a validation error.
+ */
+export declare const formDataToInput: (schema: Schema.Schema.Any, entries: Iterable<FormEntry>) => Record<string, unknown>;
+
+/** One posted entry. File entries must be filtered out by the caller —
+ *  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
+ * only the one that was submitted. The SSR render passes it through the
+ * server-request context; the client reads the same payload back off the
+ * `#__voltro_form_flash__` JSON script, so a late-hydrating page shows the
+ * identical state (no mismatch, no vanished errors).
+ */
+export declare interface FormFlashPayload {
+    /** The submitted form's key — `<AutoForm formKey>` or its mutation tag. */
+    readonly formKey: string;
+    /** The mapped input values as posted (pre-decode), to re-fill the fields. */
+    readonly values: Readonly<Record<string, unknown>>;
+    /** First error per field — the `validateFields` shape. */
+    readonly errors: Readonly<Record<string, string>>;
+    /** A non-field error (the RPC refused after valid input: guard, server). */
+    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
+ * its properties (same descriptor shape as `schemaToFields`, reused for
+ * `<DataTable>` cells). Returns `[]` if the output isn't an array of objects.
+ */
+export declare const schemaToColumns: (schema: Schema.Schema.Any) => ReadonlyArray<FieldDescriptor>;
+
+/**
+ * Derive the ordered field list for a `Schema.Struct` input. Returns `[]` for a
+ * schema with no object properties (a scalar, `Schema.Void`, or anything
+ * `JSONSchema.make` cannot represent).
+ */
+export declare const schemaToFields: (schema: Schema.Schema.Any) => ReadonlyArray<FieldDescriptor>;
+
+/**
+ * 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, 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' | 'array' | 'reference' | 'custom';
+
+export { }

package/dist/form.js

@@ -0,0 +1,2 @@
+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 };