@llmnative/react 1.9.0 → 1.10.0

package/dist/types/src/components/widgets/Form.d.ts

@@ -26,6 +26,14 @@ interface FormContextProps {
     inputType?: InputType;
     defaultValue?: FieldValue;
     inheritWrapperClassName?: boolean;
+    /** Opt-in esplicito per i pochi consumer che leggono ALTRI campi del form (cross-field), non
+     * solo il proprio `name` — es. interpolazione `{{variabile}}` da qualunque campo (Prompt.tsx).
+     * Default `false`: il consumer si ri-renderizza solo quando cambia il proprio `name`, non ad
+     * ogni cambiamento nel form. Un consumer che sottoscrive un path "genitore" (non-leaf, es. un
+     * blocco di campi annidati) NON ha bisogno di questo flag: reagisce già a qualunque discendente
+     * cambi, perché applyChangeToRecord clona ogni container lungo il percorso dalla radice alla
+     * chiave finale, quindi il valore al path genitore cambia riferimento comunque. */
+    subscribeToFullRecord?: boolean;
 }
 interface FormContextResult {
     value: FieldValue;
@@ -66,7 +74,7 @@ export declare const FormValidationContext: React.Context<FormValidationContextV
  * their error message. Call it in every field that supports `required`.
  */
 export declare const useFieldValidation: (name: string, constraints: FieldValidationConstraints) => string | undefined;
-export declare const useFormContext: ({ name, onChange, wrapperClassName, inputType, defaultValue, inheritWrapperClassName }: FormContextProps) => FormContextResult;
+export declare const useFormContext: ({ name, onChange, wrapperClassName, inputType, defaultValue, inheritWrapperClassName, subscribeToFullRecord }: FormContextProps) => FormContextResult;
 type UseHandleDropProps = {
     name: string;
     value: FieldValue;

package/dist/types/src/libs/utils.d.ts

@@ -53,4 +53,12 @@ export declare const base64ToBlob: (base64: string, type: string) => Blob | unde
 export declare const base64ToUrl: (base64: string, type: string) => string | undefined;
 export declare const getRecordValue: (record?: RecordProps, name?: string) => unknown;
 export declare const cleanRecord: (record: RecordProps | undefined) => RecordProps;
+/** Confronto di uguaglianza con la STESSA semantica di normalizzazione di `cleanRecord` (chiave
+ * con valore `undefined` = assente, `File` confrontato per `name/type/size/lastModified`, array
+ * mappati e filtrati ricorsivamente, oggetti ricorsivi) ma SENZA cloni/allocazioni intermedie:
+ * ritorna `false` non appena trova la prima differenza. Usata da `Form.tsx` per `isDirty` — a
+ * differenza di `createRecordSnapshot`/`cleanRecord` (clone ricorsivo completo + JSON.stringify
+ * dell'INTERO record, anche quando è cambiato un solo campo), qui il costo è proporzionale a
+ * quanto viaggia prima di trovare la prima differenza, tipicamente il campo appena editato. */
+export declare function recordsEqual(a: unknown, b: unknown): boolean;
 export declare const smartTypeCast: (value: unknown) => string | number | boolean | null | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",