dynamic-mui 2.0.25 → 2.1.0

package/dist/XmlShapeDeserializer-3yQdm0b0.mjs

@@ -0,0 +1,237 @@
+import { S as D, N as S, d as $, L as F, b as A, e as O, U as R } from "./index-Cr6Wp_S-.mjs";
+import { a as w, t as x } from "./date-utils-pGzaKb0p.mjs";
+function W(s) {
+  return encodeURIComponent(s).replace(/[!'()*]/g, function(r) {
+    return "%" + r.charCodeAt(0).toString(16).toUpperCase();
+  });
+}
+const y = "(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)(?:[ne|u?r]?s?day)?", b = "(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)", N = "(\\d?\\d):(\\d{2}):(\\d{2})(?:\\.(\\d+))?", M = "(\\d?\\d)", E = "(\\d{4})", U = new RegExp(/^(\d{4})-(\d\d)-(\d\d)[tT](\d\d):(\d\d):(\d\d)(\.(\d+))?(([-+]\d\d:\d\d)|[zZ])$/), k = new RegExp(`^${y}, ${M} ${b} ${E} ${N} GMT$`), z = new RegExp(`^${y}, ${M}-${b}-(\\d\\d) ${N} GMT$`), I = new RegExp(`^${y} ${b} ( [1-9]|\\d\\d) ${N} ${E}$`), _ = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], L = (s) => {
+  if (s == null)
+    return;
+  let r = NaN;
+  if (typeof s == "number")
+    r = s;
+  else if (typeof s == "string") {
+    if (!/^-?\d*\.?\d+$/.test(s))
+      throw new TypeError("parseEpochTimestamp - numeric string invalid.");
+    r = Number.parseFloat(s);
+  } else typeof s == "object" && s.tag === 1 && (r = s.value);
+  if (isNaN(r) || Math.abs(r) === 1 / 0)
+    throw new TypeError("Epoch timestamps must be valid finite numbers.");
+  return new Date(Math.round(r * 1e3));
+}, P = (s) => {
+  if (s == null)
+    return;
+  if (typeof s != "string")
+    throw new TypeError("RFC3339 timestamps must be strings");
+  const r = U.exec(s);
+  if (!r)
+    throw new TypeError(`Invalid RFC3339 timestamp format ${s}`);
+  const [, e, t, o, n, i, c, , m, f] = r;
+  h(t, 1, 12), h(o, 1, 31), h(n, 0, 23), h(i, 0, 59), h(c, 0, 60);
+  const a = new Date(Date.UTC(Number(e), Number(t) - 1, Number(o), Number(n), Number(i), Number(c), Number(m) ? Math.round(parseFloat(`0.${m}`) * 1e3) : 0));
+  if (a.setUTCFullYear(Number(e)), f.toUpperCase() != "Z") {
+    const [, d, l, u] = /([+-])(\d\d):(\d\d)/.exec(f) || [void 0, "+", 0, 0], p = d === "-" ? 1 : -1;
+    a.setTime(a.getTime() + p * (Number(l) * 60 * 60 * 1e3 + Number(u) * 60 * 1e3));
+  }
+  return a;
+}, B = (s) => {
+  if (s == null)
+    return;
+  if (typeof s != "string")
+    throw new TypeError("RFC7231 timestamps must be strings.");
+  let r, e, t, o, n, i, c, m;
+  if ((m = k.exec(s)) ? [, r, e, t, o, n, i, c] = m : (m = z.exec(s)) ? ([, r, e, t, o, n, i, c] = m, t = (Number(t) + 1900).toString()) : (m = I.exec(s)) && ([, e, r, o, n, i, c, t] = m), t && i) {
+    const f = Date.UTC(Number(t), _.indexOf(e), Number(r), Number(o), Number(n), Number(i), c ? Math.round(parseFloat(`0.${c}`) * 1e3) : 0);
+    h(r, 1, 31), h(o, 0, 23), h(n, 0, 59), h(i, 0, 60);
+    const a = new Date(f);
+    return a.setUTCFullYear(Number(t)), a;
+  }
+  throw new TypeError(`Invalid RFC7231 date-time value ${s}.`);
+};
+function h(s, r, e) {
+  const t = Number(s);
+  if (t < r || t > e)
+    throw new Error(`Value ${t} out of range [${r}, ${e}]`);
+}
+const J = (s) => {
+  const r = s.length, e = [];
+  let t = !1, o, n = 0;
+  for (let i = 0; i < r; ++i) {
+    const c = s[i];
+    switch (c) {
+      case '"':
+        o !== "\\" && (t = !t);
+        break;
+      case ",":
+        t || (e.push(s.slice(n, i)), n = i + 1);
+        break;
+    }
+    o = c;
+  }
+  return e.push(s.slice(n)), e.map((i) => {
+    i = i.trim();
+    const c = i.length;
+    return c < 2 ? i : (i[0] === '"' && i[c - 1] === '"' && (i = i.slice(1, c - 1)), i.replace(/\\"/g, '"'));
+  });
+};
+class V extends D {
+  settings;
+  constructor(r) {
+    super(), this.settings = r;
+  }
+  read(r, e) {
+    const t = S.of(r);
+    if (t.isListSchema())
+      return J(e).map((o) => this.read(t.getValueSchema(), o));
+    if (t.isBlobSchema())
+      return (this.serdeContext?.base64Decoder ?? w)(e);
+    if (t.isTimestampSchema())
+      switch ($(t, this.settings)) {
+        case 5:
+          return P(e);
+        case 6:
+          return B(e);
+        case 7:
+          return L(e);
+        default:
+          return console.warn("Missing timestamp format, parsing value with Date constructor:", e), new Date(e);
+      }
+    if (t.isStringSchema()) {
+      const o = t.getMergedTraits().mediaType;
+      let n = e;
+      if (o)
+        return t.getMergedTraits().httpHeader && (n = this.base64ToUtf8(n)), (o === "application/json" || o.endsWith("+json")) && (n = F.from(n)), n;
+    }
+    return t.isNumericSchema() ? Number(e) : t.isBigIntegerSchema() ? BigInt(e) : t.isBigDecimalSchema() ? new A(e, "bigDecimal") : t.isBooleanSchema() ? String(e).toLowerCase() === "true" : e;
+  }
+  base64ToUtf8(r) {
+    return (this.serdeContext?.utf8Encoder ?? x)((this.serdeContext?.base64Decoder ?? w)(r));
+  }
+}
+const C = (s) => {
+  const r = "#text";
+  for (const e in s)
+    s.hasOwnProperty(e) && s[e][r] !== void 0 ? s[e] = s[e][r] : typeof s[e] == "object" && s[e] !== null && (s[e] = C(s[e]));
+  return s;
+};
+let g;
+function X(s) {
+  g || (g = new DOMParser());
+  const r = g.parseFromString(s, "application/xml");
+  if (r.getElementsByTagName("parsererror").length > 0)
+    throw new Error("DOMParser XML parsing error.");
+  const e = (t) => {
+    if (t.nodeType === Node.TEXT_NODE && t.textContent?.trim())
+      return t.textContent;
+    if (t.nodeType === Node.ELEMENT_NODE) {
+      const o = t;
+      if (o.attributes.length === 0 && o.childNodes.length === 0)
+        return "";
+      const n = {}, i = Array.from(o.attributes);
+      for (const m of i)
+        n[`${m.name}`] = m.value;
+      const c = Array.from(o.childNodes);
+      for (const m of c) {
+        const f = e(m);
+        if (f != null) {
+          const a = m.nodeName;
+          if (c.length === 1 && i.length === 0 && a === "#text")
+            return f;
+          n[a] ? Array.isArray(n[a]) ? n[a].push(f) : n[a] = [n[a], f] : n[a] = f;
+        } else if (c.length === 1 && i.length === 0)
+          return o.textContent;
+      }
+      return n;
+    }
+    return null;
+  };
+  return {
+    [r.documentElement.nodeName]: e(r.documentElement)
+  };
+}
+class K extends O {
+  settings;
+  stringDeserializer;
+  constructor(r) {
+    super(), this.settings = r, this.stringDeserializer = new V(r);
+  }
+  setSerdeContext(r) {
+    this.serdeContext = r, this.stringDeserializer.setSerdeContext(r);
+  }
+  read(r, e, t) {
+    const o = S.of(r), n = o.getMemberSchemas();
+    if (o.isStructSchema() && o.isMemberSchema() && !!Object.values(n).find((f) => !!f.getMemberTraits().eventPayload)) {
+      const f = {}, a = Object.keys(n)[0];
+      return n[a].isBlobSchema() ? f[a] = e : f[a] = this.read(n[a], e), f;
+    }
+    const c = (this.serdeContext?.utf8Encoder ?? x)(e), m = this.parseXml(c);
+    return this.readSchema(r, t ? m[t] : m);
+  }
+  readSchema(r, e) {
+    const t = S.of(r);
+    if (t.isUnitSchema())
+      return;
+    const o = t.getMergedTraits();
+    if (t.isListSchema() && !Array.isArray(e))
+      return this.readSchema(t, [e]);
+    if (e == null)
+      return e;
+    if (typeof e == "object") {
+      const n = !!o.sparse, i = !!o.xmlFlattened;
+      if (t.isListSchema()) {
+        const m = t.getValueSchema(), f = [], a = m.getMergedTraits().xmlName ?? "member", d = i ? e : (e[0] ?? e)[a], l = Array.isArray(d) ? d : [d];
+        for (const u of l)
+          (u != null || n) && f.push(this.readSchema(m, u));
+        return f;
+      }
+      const c = {};
+      if (t.isMapSchema()) {
+        const m = t.getKeySchema(), f = t.getValueSchema();
+        let a;
+        i ? a = Array.isArray(e) ? e : [e] : a = Array.isArray(e.entry) ? e.entry : [e.entry];
+        const d = m.getMergedTraits().xmlName ?? "key", l = f.getMergedTraits().xmlName ?? "value";
+        for (const u of a) {
+          const p = u[d], T = u[l];
+          (T != null || n) && (c[p] = this.readSchema(f, T));
+        }
+        return c;
+      }
+      if (t.isStructSchema()) {
+        const m = t.isUnionSchema();
+        let f;
+        m && (f = new R(e, c));
+        for (const [a, d] of t.structIterator()) {
+          const l = d.getMergedTraits(), u = l.httpPayload ? l.xmlName ?? d.getName() : d.getMemberTraits().xmlName ?? a;
+          m && f.mark(u), e[u] != null && (c[a] = this.readSchema(d, e[u]));
+        }
+        return m && f.writeUnknown(), c;
+      }
+      if (t.isDocumentSchema())
+        return e;
+      throw new Error(`@aws-sdk/core/protocols - xml deserializer unhandled schema type for ${t.getName(!0)}`);
+    }
+    return t.isListSchema() ? [] : t.isMapSchema() || t.isStructSchema() ? {} : this.stringDeserializer.read(t, e);
+  }
+  parseXml(r) {
+    if (r.length) {
+      let e;
+      try {
+        e = X(r);
+      } catch (i) {
+        throw i && typeof i == "object" && Object.defineProperty(i, "$responseBodyText", {
+          value: r
+        }), i;
+      }
+      const t = "#text", o = Object.keys(e)[0], n = e[o];
+      return n[t] && (n[o] = n[t], delete n[t]), C(n);
+    }
+    return {};
+  }
+}
+export {
+  V as F,
+  K as X,
+  W as e,
+  J as s
+};

package/dist/XmlShapeDeserializer-XKJAoqLc.js

@@ -0,0 +1 @@
+"use strict";const h=require("./index-DKS5Sz9e.js"),g=require("./date-utils-CFUUt6NL.js");function $(s){return encodeURIComponent(s).replace(/[!'()*]/g,function(r){return"%"+r.charCodeAt(0).toString(16).toUpperCase()})}const N="(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)(?:[ne|u?r]?s?day)?",b="(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)",T="(\\d?\\d):(\\d{2}):(\\d{2})(?:\\.(\\d+))?",w="(\\d?\\d)",E="(\\d{4})",F=new RegExp(/^(\d{4})-(\d\d)-(\d\d)[tT](\d\d):(\d\d):(\d\d)(\.(\d+))?(([-+]\d\d:\d\d)|[zZ])$/),A=new RegExp(`^${N}, ${w} ${b} ${E} ${T} GMT$`),O=new RegExp(`^${N}, ${w}-${b}-(\\d\\d) ${T} GMT$`),U=new RegExp(`^${N} ${b} ( [1-9]|\\d\\d) ${T} ${E}$`),R=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],z=s=>{if(s==null)return;let r=NaN;if(typeof s=="number")r=s;else if(typeof s=="string"){if(!/^-?\d*\.?\d+$/.test(s))throw new TypeError("parseEpochTimestamp - numeric string invalid.");r=Number.parseFloat(s)}else typeof s=="object"&&s.tag===1&&(r=s.value);if(isNaN(r)||Math.abs(r)===1/0)throw new TypeError("Epoch timestamps must be valid finite numbers.");return new Date(Math.round(r*1e3))},I=s=>{if(s==null)return;if(typeof s!="string")throw new TypeError("RFC3339 timestamps must be strings");const r=F.exec(s);if(!r)throw new TypeError(`Invalid RFC3339 timestamp format ${s}`);const[,e,t,o,n,i,c,,m,d]=r;l(t,1,12),l(o,1,31),l(n,0,23),l(i,0,59),l(c,0,60);const a=new Date(Date.UTC(Number(e),Number(t)-1,Number(o),Number(n),Number(i),Number(c),Number(m)?Math.round(parseFloat(`0.${m}`)*1e3):0));if(a.setUTCFullYear(Number(e)),d.toUpperCase()!="Z"){const[,f,p,u]=/([+-])(\d\d):(\d\d)/.exec(d)||[void 0,"+",0,0],S=f==="-"?1:-1;a.setTime(a.getTime()+S*(Number(p)*60*60*1e3+Number(u)*60*1e3))}return a},k=s=>{if(s==null)return;if(typeof s!="string")throw new TypeError("RFC7231 timestamps must be strings.");let r,e,t,o,n,i,c,m;if((m=A.exec(s))?[,r,e,t,o,n,i,c]=m:(m=O.exec(s))?([,r,e,t,o,n,i,c]=m,t=(Number(t)+1900).toString()):(m=U.exec(s))&&([,e,r,o,n,i,c,t]=m),t&&i){const d=Date.UTC(Number(t),R.indexOf(e),Number(r),Number(o),Number(n),Number(i),c?Math.round(parseFloat(`0.${c}`)*1e3):0);l(r,1,31),l(o,0,23),l(n,0,59),l(i,0,60);const a=new Date(d);return a.setUTCFullYear(Number(t)),a}throw new TypeError(`Invalid RFC7231 date-time value ${s}.`)};function l(s,r,e){const t=Number(s);if(t<r||t>e)throw new Error(`Value ${t} out of range [${r}, ${e}]`)}const M=s=>{const r=s.length,e=[];let t=!1,o,n=0;for(let i=0;i<r;++i){const c=s[i];switch(c){case'"':o!=="\\"&&(t=!t);break;case",":t||(e.push(s.slice(n,i)),n=i+1);break}o=c}return e.push(s.slice(n)),e.map(i=>{i=i.trim();const c=i.length;return c<2?i:(i[0]==='"'&&i[c-1]==='"'&&(i=i.slice(1,c-1)),i.replace(/\\"/g,'"'))})};class C extends h.SerdeContext{settings;constructor(r){super(),this.settings=r}read(r,e){const t=h.NormalizedSchema.of(r);if(t.isListSchema())return M(e).map(o=>this.read(t.getValueSchema(),o));if(t.isBlobSchema())return(this.serdeContext?.base64Decoder??g.fromBase64)(e);if(t.isTimestampSchema())switch(h.determineTimestampFormat(t,this.settings)){case 5:return I(e);case 6:return k(e);case 7:return z(e);default:return console.warn("Missing timestamp format, parsing value with Date constructor:",e),new Date(e)}if(t.isStringSchema()){const o=t.getMergedTraits().mediaType;let n=e;if(o)return t.getMergedTraits().httpHeader&&(n=this.base64ToUtf8(n)),(o==="application/json"||o.endsWith("+json"))&&(n=h.LazyJsonString.from(n)),n}return t.isNumericSchema()?Number(e):t.isBigIntegerSchema()?BigInt(e):t.isBigDecimalSchema()?new h.NumericValue(e,"bigDecimal"):t.isBooleanSchema()?String(e).toLowerCase()==="true":e}base64ToUtf8(r){return(this.serdeContext?.utf8Encoder??g.toUtf8)((this.serdeContext?.base64Decoder??g.fromBase64)(r))}}const D=s=>{const r="#text";for(const e in s)s.hasOwnProperty(e)&&s[e][r]!==void 0?s[e]=s[e][r]:typeof s[e]=="object"&&s[e]!==null&&(s[e]=D(s[e]));return s};let y;function _(s){y||(y=new DOMParser);const r=y.parseFromString(s,"application/xml");if(r.getElementsByTagName("parsererror").length>0)throw new Error("DOMParser XML parsing error.");const e=t=>{if(t.nodeType===Node.TEXT_NODE&&t.textContent?.trim())return t.textContent;if(t.nodeType===Node.ELEMENT_NODE){const o=t;if(o.attributes.length===0&&o.childNodes.length===0)return"";const n={},i=Array.from(o.attributes);for(const m of i)n[`${m.name}`]=m.value;const c=Array.from(o.childNodes);for(const m of c){const d=e(m);if(d!=null){const a=m.nodeName;if(c.length===1&&i.length===0&&a==="#text")return d;n[a]?Array.isArray(n[a])?n[a].push(d):n[a]=[n[a],d]:n[a]=d}else if(c.length===1&&i.length===0)return o.textContent}return n}return null};return{[r.documentElement.nodeName]:e(r.documentElement)}}class B extends h.SerdeContextConfig{settings;stringDeserializer;constructor(r){super(),this.settings=r,this.stringDeserializer=new C(r)}setSerdeContext(r){this.serdeContext=r,this.stringDeserializer.setSerdeContext(r)}read(r,e,t){const o=h.NormalizedSchema.of(r),n=o.getMemberSchemas();if(o.isStructSchema()&&o.isMemberSchema()&&!!Object.values(n).find(d=>!!d.getMemberTraits().eventPayload)){const d={},a=Object.keys(n)[0];return n[a].isBlobSchema()?d[a]=e:d[a]=this.read(n[a],e),d}const c=(this.serdeContext?.utf8Encoder??g.toUtf8)(e),m=this.parseXml(c);return this.readSchema(r,t?m[t]:m)}readSchema(r,e){const t=h.NormalizedSchema.of(r);if(t.isUnitSchema())return;const o=t.getMergedTraits();if(t.isListSchema()&&!Array.isArray(e))return this.readSchema(t,[e]);if(e==null)return e;if(typeof e=="object"){const n=!!o.sparse,i=!!o.xmlFlattened;if(t.isListSchema()){const m=t.getValueSchema(),d=[],a=m.getMergedTraits().xmlName??"member",f=i?e:(e[0]??e)[a],p=Array.isArray(f)?f:[f];for(const u of p)(u!=null||n)&&d.push(this.readSchema(m,u));return d}const c={};if(t.isMapSchema()){const m=t.getKeySchema(),d=t.getValueSchema();let a;i?a=Array.isArray(e)?e:[e]:a=Array.isArray(e.entry)?e.entry:[e.entry];const f=m.getMergedTraits().xmlName??"key",p=d.getMergedTraits().xmlName??"value";for(const u of a){const S=u[f],x=u[p];(x!=null||n)&&(c[S]=this.readSchema(d,x))}return c}if(t.isStructSchema()){const m=t.isUnionSchema();let d;m&&(d=new h.UnionSerde(e,c));for(const[a,f]of t.structIterator()){const p=f.getMergedTraits(),u=p.httpPayload?p.xmlName??f.getName():f.getMemberTraits().xmlName??a;m&&d.mark(u),e[u]!=null&&(c[a]=this.readSchema(f,e[u]))}return m&&d.writeUnknown(),c}if(t.isDocumentSchema())return e;throw new Error(`@aws-sdk/core/protocols - xml deserializer unhandled schema type for ${t.getName(!0)}`)}return t.isListSchema()?[]:t.isMapSchema()||t.isStructSchema()?{}:this.stringDeserializer.read(t,e)}parseXml(r){if(r.length){let e;try{e=_(r)}catch(i){throw i&&typeof i=="object"&&Object.defineProperty(i,"$responseBodyText",{value:r}),i}const t="#text",o=Object.keys(e)[0],n=e[o];return n[t]&&(n[o]=n[t],delete n[t]),D(n)}return{}}}exports.FromStringShapeDeserializer=C;exports.XmlShapeDeserializer=B;exports.extendedEncodeURIComponent=$;exports.splitHeader=M;

package/dist/ai/client.d.ts

@@ -0,0 +1,2 @@
+import { AIClient, AIClientConfig } from './types';
+export declare function createAIClient(config: AIClientConfig): AIClient;

package/dist/ai/index.d.ts

@@ -0,0 +1,4 @@
+export { createAIClient } from './client';
+export { simpleFieldsToFormFields, formFieldsToSimple, slug } from './mapping';
+export * from './types';
+export { AIFormGenerator, AIFill, AITextAssist, useAIAssist, AISchemaReview, AIVisionImport, AIForm } from './react';

package/dist/ai/mapping.d.ts

@@ -0,0 +1,14 @@
+import { FormField } from '../types';
+import { SimpleField, ExtractionField } from './types';
+/** Turn a label into a stable snake_case id/value. */
+export declare const slug: (s: string) => string;
+/** Convert LLM-friendly SimpleField[] into renderable FormField[]. */
+export declare function simpleFieldsToFormFields(fields: SimpleField[]): FormField[];
+/**
+ * Describe a rendered form's fields for AI extraction — includes each field's
+ * valid `options` and `format` so the model returns values the controls accept
+ * (e.g. a real Select option value, not just a label guess).
+ */
+export declare function fieldsForExtraction(schema: FormField[]): ExtractionField[];
+/** Best-effort reverse map (FormField[] → SimpleField[]) for edit/review round-trips. */
+export declare function formFieldsToSimple(fields: FormField[]): SimpleField[];

package/dist/ai/react/AIFill.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { AIClient, ExtractionField } from '../types';
+import { FormField } from '../../types';
+/** A field descriptor understood by `AIClient.extractToFields`. */
+export type AIFillField = ExtractionField;
+export interface AIFillProps {
+    /** Injected, provider-agnostic AI client. This component never calls the network directly. */
+    client: AIClient;
+    /** Full form schema; field descriptors are derived from it when `fields` is omitted. */
+    schema?: FormField[];
+    /** Explicit field descriptors. Takes precedence over `schema`. */
+    fields?: AIFillField[];
+    /** Called with the extracted values (always called, even with `{}`). */
+    onFill: (values: Record<string, any>) => void;
+    /** Placeholder for the paste box. */
+    placeholder?: string;
+    /** Label for the paste box. */
+    label?: string;
+}
+/**
+ * "Paste to autofill": the user pastes free text, and the injected `AIClient`
+ * extracts values for the form's fields.
+ */
+export declare const AIFill: React.FC<AIFillProps>;
+export default AIFill;

package/dist/ai/react/AIForm.d.ts

@@ -0,0 +1,29 @@
+import { FormField } from '../../types';
+import { AIClient } from '../types';
+import { FormGeneratorProps } from '../../components/FormGenerator';
+export interface AIFormProps {
+    /** Injected, provider-agnostic AI client. */
+    client: AIClient;
+    /** The form schema (JSON). Used as the initial schema; AI edits update it internally. */
+    data: FormField[];
+    guid: string;
+    /** Initial field values. */
+    patch?: Record<string, any>;
+    onSubmit?: FormGeneratorProps['onSubmit'];
+    onChange?: FormGeneratorProps['onChange'];
+    /** Called whenever AI (generate / review) changes the schema. */
+    onSchemaChange?: (fields: FormField[]) => void;
+    /** Toolbar toggles. */
+    enableFill?: boolean;
+    enableReview?: boolean;
+    enableGenerate?: boolean;
+    formRef?: FormGeneratorProps['formRef'];
+    /** Extra props forwarded to the inner FormGenerator. */
+    formProps?: Partial<FormGeneratorProps>;
+}
+/**
+ * Drop-in form + AI. Renders a `FormGenerator` from `data` and a small AI toolbar
+ * that can generate/edit the schema, review it, and paste-to-fill the values —
+ * all wired to the internal schema/patch state. One line to add AI to any form.
+ */
+export default function AIForm({ client, data, guid, patch, onSubmit, onChange, onSchemaChange, enableFill, enableReview, enableGenerate, formRef, formProps, }: AIFormProps): import("react/jsx-runtime").JSX.Element;

package/dist/ai/react/AIFormGenerator.d.ts

@@ -0,0 +1,20 @@
+import { AIClient } from '../types';
+import { FormField } from '../../types';
+export interface AIFormGeneratorProps {
+    /** Provider-agnostic AI client (injected). Never calls the network directly. */
+    client: AIClient;
+    /** When provided and non-empty, the component edits this form instead of generating a new one. */
+    current?: FormField[];
+    /** Called with the generated (or edited) form schema. */
+    onGenerate: (fields: FormField[]) => void;
+    /** Placeholder text for the prompt input. */
+    placeholder?: string;
+    /** Label for the prompt input. */
+    label?: string;
+}
+/**
+ * A small, self-contained UI that turns a natural-language prompt into a
+ * renderable form schema via an injected `AIClient`. When `current` is a
+ * non-empty array it applies the prompt as an edit to that form instead.
+ */
+export default function AIFormGenerator({ client, current, onGenerate, placeholder, label, }: AIFormGeneratorProps): import("react/jsx-runtime").JSX.Element;

package/dist/ai/react/AISchemaReview.d.ts

@@ -0,0 +1,18 @@
+import { AIClient } from '../types';
+import { FormField } from '../../types';
+export interface AISchemaReviewProps {
+    /** Provider-agnostic AI client (injected). Never calls the network directly. */
+    client: AIClient;
+    /** The form schema to audit. */
+    schema: FormField[];
+    /** Called with `result.improved` when the user applies the AI's improvements. */
+    onApply?: (fields: FormField[]) => void;
+    /** Label for the review button. */
+    buttonLabel?: string;
+}
+/**
+ * Audits a form schema through an injected `AIClient` and presents the returned
+ * issues as a tidy list. When the client returns an improved schema and an
+ * `onApply` handler is provided, the user can apply it wholesale.
+ */
+export default function AISchemaReview({ client, schema, onApply, buttonLabel, }: AISchemaReviewProps): import("react/jsx-runtime").JSX.Element;

package/dist/ai/react/AITextAssist.d.ts

@@ -0,0 +1,35 @@
+import { AIClient, AssistAction } from '../types';
+/**
+ * Return value of {@link useAIAssist}. `run` invokes the injected client's
+ * `assistText`, tracking `loading`/`error` and resolving with the result text.
+ */
+export interface UseAIAssist {
+    run: (text: string, action: AssistAction, targetLanguage?: string) => Promise<string>;
+    loading: boolean;
+    error: string | null;
+}
+/**
+ * Headless hook around an injected {@link AIClient}. Never calls the network
+ * directly — it delegates to `client.assistText` and surfaces loading/error.
+ */
+export declare function useAIAssist(client: AIClient): UseAIAssist;
+export interface AITextAssistProps {
+    /** Provider-agnostic AI client (injected). Never calls the network directly. */
+    client: AIClient;
+    /** The text the selected action operates on. */
+    text: string;
+    /** Which assist actions to offer. Defaults to all seven. */
+    actions?: AssistAction[];
+    /** Called with the transformed text once an action resolves. */
+    onResult: (text: string) => void;
+    /** Target language, forwarded for the `translate` action. */
+    targetLanguage?: string;
+    /** Size of the trigger icon button. */
+    size?: 'small' | 'medium';
+}
+/**
+ * A compact "AI assist" trigger: an icon button that opens a menu of text
+ * transformations (improve, summarize, translate, …). Selecting one runs it
+ * through the injected {@link AIClient} and hands the result to `onResult`.
+ */
+export default function AITextAssist({ client, text, actions, onResult, targetLanguage, size, }: AITextAssistProps): import("react/jsx-runtime").JSX.Element;

package/dist/ai/react/AIVisionImport.d.ts

@@ -0,0 +1,21 @@
+import { AIClient } from '../types';
+import { FormField } from '../../types';
+export interface AIVisionImportProps {
+    client: AIClient;
+    /** 'generate' → digitize a form image into a schema; 'fill' → read a document into fields. */
+    mode?: 'generate' | 'fill';
+    /** For 'fill' mode: the form to populate (fields are derived from it). */
+    schema?: FormField[];
+    /** For 'fill' mode: explicit field list (overrides schema). */
+    fields?: {
+        id: string;
+        label?: string;
+        type?: string;
+    }[];
+    onGenerate?: (fields: FormField[]) => void;
+    onFill?: (values: Record<string, any>) => void;
+    label?: string;
+    accept?: string;
+}
+/** Upload a document/photo and let AI (vision) either build a form from it or fill fields. */
+export default function AIVisionImport({ client, mode, schema, fields, onGenerate, onFill, label, accept, }: AIVisionImportProps): import("react/jsx-runtime").JSX.Element;

package/dist/ai/react/index.d.ts

@@ -0,0 +1,6 @@
+export { default as AIFormGenerator } from './AIFormGenerator';
+export { default as AIFill } from './AIFill';
+export { default as AITextAssist, useAIAssist } from './AITextAssist';
+export { default as AISchemaReview } from './AISchemaReview';
+export { default as AIVisionImport } from './AIVisionImport';
+export { default as AIForm } from './AIForm';

package/dist/ai/types.d.ts

@@ -0,0 +1,107 @@
+import { FormField } from '../types';
+/**
+ * A simplified, LLM-friendly field description. The AI works in terms of these
+ * (flat, easy to reason about) and the mapping layer converts them to/from the
+ * library's richer `FormField` schema.
+ */
+export interface SimpleField {
+    /** Semantic control kind (see mapping for the supported set + aliases). */
+    type: string;
+    /** Stable field id. */
+    id: string;
+    /** Human label. */
+    label: string;
+    required?: boolean;
+    placeholder?: string;
+    helperText?: string;
+    /** Options for choice fields (select/radio/chipselect/togglebuttons). */
+    options?: string[];
+    multiple?: boolean;
+    /** Layout width hint. */
+    width?: 'full' | 'half' | 'third';
+    /** Arithmetic formula for computed fields, e.g. "qty * price". */
+    formula?: string;
+    /** Simple conditional-visibility hint. */
+    visibleWhen?: {
+        field: string;
+        op?: string;
+        value?: any;
+    };
+}
+export type AssistAction = 'improve' | 'summarize' | 'expand' | 'shorten' | 'fix-grammar' | 'professional' | 'translate';
+/** A field descriptor the AI uses when extracting values into a form. */
+export interface ExtractionField {
+    id: string;
+    label?: string;
+    type?: string;
+    /** Valid option values (for select/radio/chip/etc.) so the model returns a real one. */
+    options?: string[];
+    /** Date/number format hint, e.g. "MM/DD/YYYY". */
+    format?: string;
+}
+export interface ReviewIssue {
+    /** Field id the issue relates to (omitted for form-wide issues). */
+    field?: string;
+    /** Category of suggestion. */
+    kind: 'label' | 'validation' | 'logic' | 'type' | 'accessibility' | 'other';
+    severity: 'info' | 'suggestion' | 'warning';
+    message: string;
+}
+export interface ReviewResult {
+    issues: ReviewIssue[];
+    /** An improved version of the whole form the user can apply wholesale. */
+    improved?: FormField[];
+}
+/** OpenAI content part — text or an image (for vision requests). */
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+};
+/** Low-level OpenAI-style chat payload sent to the (user-hosted) proxy. */
+export interface ChatRequest {
+    messages: {
+        role: 'system' | 'user' | 'assistant';
+        content: string | ContentPart[];
+    }[];
+    /** When true, ask the model for a JSON object and parse the response. */
+    json?: boolean;
+    temperature?: number;
+    model?: string;
+}
+export interface AIClientConfig {
+    /** URL of YOUR backend proxy that injects the OpenAI key server-side. */
+    endpoint: string;
+    /** Extra headers (e.g. auth) sent to your proxy. */
+    headers?: Record<string, string>;
+    /** Default model (your proxy may override/ignore). Default 'gpt-4o-mini'. */
+    model?: string;
+    /** Injectable fetch (for tests / non-browser envs). Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+}
+export interface GenerateOptions {
+    /** Restrict generation to these control types (defaults to a curated set). */
+    allowedTypes?: string[];
+}
+export interface AIClient {
+    /** Low-level escape hatch — send a chat request to your proxy. */
+    chat(req: ChatRequest): Promise<any>;
+    /** Natural-language prompt → a renderable form schema. */
+    generateForm(prompt: string, opts?: GenerateOptions): Promise<FormField[]>;
+    /** Apply a natural-language edit to an existing form. */
+    editForm(current: FormField[], instruction: string): Promise<FormField[]>;
+    /** Audit a form and suggest improvements (+ an optional improved version). */
+    reviewForm(current: FormField[]): Promise<ReviewResult>;
+    /** Extract values from free text/paste into the given fields. */
+    extractToFields(text: string, fields: ExtractionField[]): Promise<Record<string, any>>;
+    /** Transform a piece of text (rewrite/summarize/translate/…). */
+    assistText(text: string, action: AssistAction, targetLanguage?: string): Promise<string>;
+    /** Vision: digitize a document/photo of a form into a renderable schema. */
+    generateFormFromImage(images: string | string[], prompt?: string, opts?: GenerateOptions): Promise<FormField[]>;
+    /** Vision: read a document/photo (receipt, ID, invoice…) into the given fields. */
+    extractFromImage(images: string | string[], fields: ExtractionField[]): Promise<Record<string, any>>;
+}

package/dist/components/FormGenerator.d.ts

@@ -33,5 +33,18 @@ export interface FormGeneratorProps {
     onFieldDoubleClick?: (field: FormField) => void;
     /** On Field Context Menu (Internal/Builder) */
     onFieldContextMenu?: (event: React.MouseEvent, field: FormField) => void;
+    /**
+     * By default a form's stored data is removed from the shared store when the
+     * component unmounts, preventing the store from growing unbounded across
+     * mount/unmount cycles. Set to `true` to keep the data available via
+     * `FormData(guid)` after the form has unmounted.
+     */
+    persistOnUnmount?: boolean;
+    /** Persist form data to browser storage and restore it on mount (draft/auto-save). */
+    autoSave?: boolean;
+    /** Storage key for auto-save (defaults to `dynamic-mui:<guid>`). */
+    autoSaveKey?: string;
+    /** Which browser storage to use for auto-save (default 'local'). */
+    autoSaveStorage?: 'local' | 'session';
 }
-export declare function FormGenerator({ data, patch, guid, formRef, onSubmit, onChange, onStepChange, MuiGridAttributes, activeStep, onFieldClick, onFieldDoubleClick, onFieldContextMenu, }: FormGeneratorProps): import("react/jsx-runtime").JSX.Element;
+export declare function FormGenerator({ data, patch, guid, formRef, onSubmit, onChange, onStepChange, MuiGridAttributes, activeStep, onFieldClick, onFieldDoubleClick, onFieldContextMenu, persistOnUnmount, autoSave, autoSaveKey, autoSaveStorage, }: FormGeneratorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/AddressField/addressfield.d.ts

@@ -0,0 +1,2 @@
+import { ControlProps } from '../../../types';
+export default function AddressField({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/Alert/alert.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** Alert Control — display-only informational banner. */
+export default function Alert({ attributes }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/Button/button.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** Button Component */
+export default function Button({ attributes, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/CascadeSelect/cascadeselect.d.ts

@@ -0,0 +1,2 @@
+import { ControlProps } from '../../../types';
+export default function CascadeSelect({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/ChipSelect/chipselect.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** Premium selectable-chip control supporting single and multi select. */
+export default function ChipSelect({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/ColorPicker/colorpicker.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** ColorPicker Control — a colour swatch, a native colour input and a hex field. */
+export default function ColorPicker({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/Computed/computed.d.ts

@@ -0,0 +1,7 @@
+import { ControlProps } from '../../../types';
+/**
+ * Read-only display for a computed / formula field. The value is derived and
+ * supplied by FormGenerator's rule engine (via the field's `formula`); this
+ * control just presents it, optionally number-formatted, with a prefix/suffix.
+ */
+export default function Computed({ attributes }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/ConsentField/consentfield.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** ConsentField Component — scrollable terms box with a scroll-to-accept checkbox. */
+export default function ConsentField({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/CurrencyField/currencyfield.d.ts

@@ -0,0 +1,2 @@
+import { ControlProps } from '../../../types';
+export default function CurrencyField({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/DateRangePicker/daterangepicker.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** DateRangePicker Component — two DatePickers (Start + End) laid out in a row. */
+export default function DateRangePicker({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/FileUpload/fileupload.d.ts

@@ -0,0 +1,3 @@
+import { ControlProps } from '../../../types';
+/** FileUpload Control — dropzone + S3 upload with preview list. */
+export default function FileUpload({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/FormWizard/formwizard.d.ts

@@ -0,0 +1,2 @@
+import { ControlProps } from '../../../types';
+export default function FormWizard({ attributes, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/GeoField/geofield.d.ts

@@ -0,0 +1,6 @@
+import { ControlProps } from '../../../types';
+/**
+ * Latitude + longitude coordinate picker with an "Open in Maps" link and an
+ * optional OpenStreetMap embed (opt-in via `showMap`).
+ */
+export default function GeoField({ attributes, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/controls/KeyValueField/keyvaluefield.d.ts

@@ -0,0 +1,2 @@
+import { ControlProps } from '../../../types';
+export default function KeyValueField({ attributes, rules, onChange }: ControlProps): import("react/jsx-runtime").JSX.Element;