[{"data":1,"prerenderedAt":474},["ShallowReactive",2],{"content-\u002Fdocs\u002Fdevtools-and-debugging\u002Fdevtools-panel":3},{"id":4,"title":5,"body":6,"description":452,"extension":453,"meta":454,"metaRows":455,"navigation":468,"path":469,"seo":470,"source":471,"stem":472,"__hash__":473},"docs\u002Fdocs\u002Fdevtools-and-debugging\u002Fdevtools-panel.md","The Attaform DevTools panel",{"type":7,"value":8,"toc":437},"minimark",[9,13,20,23,36,41,48,116,125,132,136,141,148,152,167,170,174,200,207,211,214,245,248,252,255,282,285,289,292,352,359,363,366,370,381,385,415,419,433],[10,11,5],"h1",{"id":12},"the-attaform-devtools-panel",[14,15,16],"blockquote",{},[17,18,19],"p",{},"A first-class native tab in the Nuxt DevTools sidebar. Every form's value, errors, aggregates, per-field state, and event timeline, with an editable JSON tree for the values.",[21,22],"docs-meta-table",{},[17,24,25,26,30,31,35],{},"This page is code-only; the panel lives in your browser's Nuxt DevTools overlay, not inside the docs site. Open any Nuxt-powered Attaform consumer in dev (",[27,28,29],"code",{},"Shift + Option + D"," opens the overlay) and pick ",[32,33,34],"strong",{},"Attaform"," in the sidebar to see it.",[37,38,40],"h2",{"id":39},"installing","Installing",[17,42,43,44,47],{},"The integration is automatic; adding ",[27,45,46],{},"attaform\u002Fnuxt"," to your Nuxt config wires the tab:",[49,50,55],"pre",{"className":51,"code":52,"language":53,"meta":54,"style":54},"language-ts shiki shiki-themes github-light github-dark","\u002F\u002F nuxt.config.ts: no devtools-specific config needed\nexport default defineNuxtConfig({\n  modules: ['attaform\u002Fnuxt'],\n  devtools: { enabled: true },\n})\n","ts","",[27,56,57,66,84,97,110],{"__ignoreMap":54},[58,59,62],"span",{"class":60,"line":61},"line",1,[58,63,65],{"class":64},"sJ8bj","\u002F\u002F nuxt.config.ts: no devtools-specific config needed\n",[58,67,69,73,76,80],{"class":60,"line":68},2,[58,70,72],{"class":71},"szBVR","export",[58,74,75],{"class":71}," default",[58,77,79],{"class":78},"sScJk"," defineNuxtConfig",[58,81,83],{"class":82},"sVt8B","({\n",[58,85,87,90,94],{"class":60,"line":86},3,[58,88,89],{"class":82},"  modules: [",[58,91,93],{"class":92},"sZZnC","'attaform\u002Fnuxt'",[58,95,96],{"class":82},"],\n",[58,98,100,103,107],{"class":60,"line":99},4,[58,101,102],{"class":82},"  devtools: { enabled: ",[58,104,106],{"class":105},"sj4cs","true",[58,108,109],{"class":82}," },\n",[58,111,113],{"class":60,"line":112},5,[58,114,115],{"class":82},"})\n",[17,117,118,119,121,122,124],{},"No peer dependency to add, no extension to install, no Vite plugin to configure. Open the Nuxt DevTools overlay (",[27,120,29],{}," or click the Nuxt logo in the bottom corner) and select ",[32,123,34],{}," from the sidebar.",[17,126,127,128,131],{},"The tab is dev-only; production builds skip the route injection and the ",[27,129,130],{},"@nuxt\u002Fdevtools-kit"," import entirely. Nothing ships in production.",[37,133,135],{"id":134},"what-you-see","What you see",[137,138,140],"h3",{"id":139},"form-list","Form list",[17,142,143,144,147],{},"One entry per registered form, keyed by the form's ",[27,145,146],{},"key",". Click a form to inspect it.",[137,149,151],{"id":150},"form-value","Form value",[17,153,154,155,158,159,162,163,166],{},"The current ",[27,156,157],{},"form.values"," as an interactive JSON tree. ",[32,160,161],{},"Editable from the panel:"," your edit flows through ",[27,164,165],{},"setValueAtPath"," and drives the whole reactive pipeline (validation, history). The panel writes back into the same store the form reads from, so a value edited in DevTools is indistinguishable from one typed into an input.",[17,168,169],{},"Values render verbatim. The panel is dev-only, so it doesn't mask passwords \u002F tokens \u002F secrets; debugging a credential flow typically needs the actual value. Close the panel before a screen share if a value would be sensitive on camera, the same hygiene as the browser's own DevTools console.",[137,171,173],{"id":172},"field-state","Field state",[17,175,176,177,179,180,183,184,183,187,183,190,183,193,196,197,199],{},"Click any key in the value tree and a ",[32,178,173],{}," section opens beneath it for that path: ",[27,181,182],{},"connected",", ",[27,185,186],{},"touched",[27,188,189],{},"focused",[27,191,192],{},"blurred",[27,194,195],{},"updatedAt",", the schema and user error counts side by side, every error message with its ",[27,198,27],{},", and the value at that path. Click the same key again, or the × in the section header, to close it.",[17,201,202,203,206],{},"This is the panel's answer to \"the field looks wrong and I can't tell why\": the interaction flags and the two error layers for one path, in one place, without reaching into ",[27,204,205],{},"form.fields"," from a breakpoint.",[137,208,210],{"id":209},"schema-errors-user-errors","Schema Errors \u002F User Errors",[17,212,213],{},"The error map keyed by path, split by source:",[215,216,217,224],"ul",{},[218,219,220,223],"li",{},[32,221,222],{},"Schema Errors",": what the validator (Zod adapter) produced. Recomputed on every validation pass, so they track the current values.",[218,225,226,229,230,233,234,183,237,240,241,244],{},[32,227,228],{},"User Errors",": the manual error layer you wrote via ",[27,231,232],{},"setErrors"," (server errors included). Never re-derived, so an entry sits here until something clears it: ",[27,235,236],{},"clearErrors",[27,238,239],{},"reset()",", or the next ",[27,242,243],{},"handleSubmit",", which wipes the layer on entry.",[17,246,247],{},"Splitting them tells you instantly whether validation or your application code emitted each error.",[137,249,251],{"id":250},"aggregates","Aggregates",[17,253,254],{},"The reactive bundle:",[215,256,257,262,267,272],{},[218,258,259],{},[27,260,261],{},"submitting",[218,263,264],{},[27,265,266],{},"submissionAttempts",[218,268,269],{},[27,270,271],{},"submitError",[218,273,274,277,278,281],{},[27,275,276],{},"activeValidations",", the in-flight validation count that ",[27,279,280],{},"form.meta.validating"," reads as a boolean",[17,283,284],{},"Useful for confirming your loading-state wiring is reading the right reactive thing.",[137,286,288],{"id":287},"timeline","Timeline",[17,290,291],{},"A scrollable log of recent events. Each entry shows a timestamp, an event type, and the form key, with the form value at the moment of fire available on click.",[293,294,295,308],"table",{},[296,297,298],"thead",{},[299,300,301,305],"tr",{},[302,303,304],"th",{},"Event",[302,306,307],{},"Fires on",[309,310,311,326,340],"tbody",{},[299,312,313,319],{},[314,315,316],"td",{},[27,317,318],{},"form.change",[314,320,321,322,325],{},"Every mutation: register inputs, ",[27,323,324],{},"setValue",", array helpers, undo \u002F redo.",[299,327,328,333],{},[314,329,330],{},[27,331,332],{},"submit.success",[314,334,335,336,339],{},"A submit handler's ",[27,337,338],{},"onSubmit"," callback resolves.",[299,341,342,347],{},[314,343,344],{},[27,345,346],{},"reset",[314,348,349,351],{},[27,350,239],{}," completes.",[17,353,354,355,358],{},"Capacity is capped at 200 events per session; older entries fall off the back. Hit ",[32,356,357],{},"clear"," to wipe the log mid-debug.",[37,360,362],{"id":361},"sensitive-data-and-the-panel","Sensitive data and the panel",[17,364,365],{},"The panel renders form values raw. DevTools is a dev-only surface, and redacting across every place a value surfaces (panels, logs, network tabs, breakpoints, source maps) is impractical security theater, not a real safeguard. For production-data spelunking on a sensitive surface, use a non-prod environment with synthetic data instead.",[37,367,369],{"id":368},"whats-coming","What's coming",[215,371,372],{},[218,373,374,377,378,380],{},[32,375,376],{},"History stack visualization."," Undo \u002F redo snapshots show on the timeline via ",[27,379,318],{}," entries; the stack itself isn't a separate node yet.",[37,382,384],{"id":383},"caveats","Caveats",[215,386,387,393,409],{},[218,388,389,392],{},[32,390,391],{},"Panel edits bypass your component bindings."," Fine for poking at state during debugging; don't rely on the path mirroring production interaction exactly.",[218,394,395,398,399,402,403,408],{},[32,396,397],{},"Multi-app setups."," The Nuxt overlay panel reads from the most recent ",[27,400,401],{},"createAttaform()"," install; micro-frontend setups with parallel apps will only see one app's forms in the Nuxt panel. Reach for ",[404,405,407],"a",{"href":406},"\u002Fdocs\u002Fdevtools-and-debugging\u002Fvue-devtools","Vue DevTools integration"," when you need per-app inspection.",[218,410,411,414],{},[32,412,413],{},"Screen-share hygiene."," The panel renders raw values. Close it before screen-sharing, the same way you'd close the browser DevTools console.",[37,416,418],{"id":417},"where-to-next","Where to next",[215,420,421,426],{},[218,422,423,425],{},[404,424,407],{"href":406},": the alternative for Vite \u002F bare-Vue projects, or as a complement on Nuxt.",[218,427,428,432],{},[404,429,431],{"href":430},"\u002Fdocs\u002Fdevtools-and-debugging\u002Ftroubleshooting","Troubleshooting",": what the panel surfaces, in narrative form.",[434,435,436],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":54,"searchDepth":68,"depth":68,"links":438},[439,440,448,449,450,451],{"id":39,"depth":68,"text":40},{"id":134,"depth":68,"text":135,"children":441},[442,443,444,445,446,447],{"id":139,"depth":86,"text":140},{"id":150,"depth":86,"text":151},{"id":172,"depth":86,"text":173},{"id":209,"depth":86,"text":210},{"id":250,"depth":86,"text":251},{"id":287,"depth":86,"text":288},{"id":361,"depth":68,"text":362},{"id":368,"depth":68,"text":369},{"id":383,"depth":68,"text":384},{"id":417,"depth":68,"text":418},"Every registered form shows up in the Nuxt DevTools sidebar with values, errors, aggregates, and a timeline of every change. Auto-wired by attaform\u002Fnuxt, dev-gated at the module level.","md",{},[456,459,462,465],{"label":457,"value":458},"Category","Module",{"label":460,"value":461},"Where","Nuxt DevTools sidebar",{"label":463,"value":464,"kind":27},"Install","attaform\u002Fnuxt, nothing else",{"label":466,"value":467},"Production","route injection skipped, no @nuxt\u002Fdevtools-kit import",true,"\u002Fdocs\u002Fdevtools-and-debugging\u002Fdevtools-panel",{"title":5,"description":452},null,"docs\u002Fdevtools-and-debugging\u002Fdevtools-panel","JGCq1b7PT0ftJQmcT_eLXYMPwZnrdgHJrYbHb5mCOpM",1792377967283]