Repository navigation
feat(webkit)!: [ENG-50003] make WebKit ready for AI agents - #1170
Draft
rafael-umann-azion wants to merge 2252 commits into
Draft
rafael-umann-azion wants to merge 2252 commits into
rafael-umann-azion wants to merge 2252 commits into
Conversation
gabriel-lisboa-azion
added a commit
that referenced
this pull request
Nov 10, 2026
Removes the type, autocomplete and spellcheck props from FieldText and InputText (ENG-49936), with their tests, specs, story argTypes and catalog entries. #1170 ships the same API.
gabriel-lisboa-azion
added a commit
that referenced
this pull request
Nov 10, 2026
Removes the type, autocomplete and spellcheck props from FieldText and InputText (ENG-49936), with their tests, specs, story argTypes and catalog entries. #1170 ships the same API.
…ct on narrow tabs
Every example hand-styled a raw input, which stayed editable in a disabled group and carried no aria-invalid in an invalid one. They now use InputGroup.Input (named with aria-label), which takes the group's state, and the currency Select is capped so the amount field keeps the row.
… detail page below md
On a coarse pointer the two stacked 15px steppers sat edge to edge. They now sit side by side on the trailing edge, each 40px wide and the field's full height; mouse layout is unchanged.
Segments were 29px tall and the overflow trigger 30x28px. Both now carry the same coarse-pointer hit area IconButton uses, so a thumb can reach them without the visual chip growing.
…r buttons full height
The handle declared no touch-action, so the browser took over the gesture and cancelled the drag after about 24px. It now sets touch-none, like the sidebar resize handle, and widens its coarse-pointer hit area to 40px.
It overrode every layered state variant, so forms, the dialog backdrop, the settings rail, switches and the collapsed search shortcut rendered wrong. The demo sources now feed the single layered set from webkit.css.
Leaving the edit page with unsaved changes now asks first (useUnsavedChanges with the leave dialog and a beforeunload warning), the Settings tab carries the dirty mark, the tabs match the detail page and open it on the chosen tab, and the copy says resource.
Monthly is the default, the figures match the plan card, and on small screens the charge comes before the feature list.
The bar now opens from one toggle and sits above a floating save bar, so it no longer hides Save and Cancel on phones.
… 2.2.2) Adds spin-settle, ping-settle, pulse-settle, blink-settle and flow-dash-settle, which run a fixed number of times and rest on a still frame within 5 seconds, and makes the pixelate texture waves drift once and ease to a stop in 4.8s instead of looping forever. Co-Authored-By: Claude Opus 5.5 <[email protected]>
…(WCAG 2.2.2) Texture pixelate waves, the highlight-button glow, the eyebrow cursor, the hotspot ping, the network-map pulse and traffic packets, and the flow-diagram and topology-diagram connector dashes now run a fixed number of times and rest on a still frame within 5 seconds, keeping their motion-reduce fallbacks. The table live-button pulse stays as an essential live status signal; its spec says so. A styled suite measures every animation's end time from the real stylesheet. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
…econds) Co-Authored-By: Claude Opus 5.5 <[email protected]>
…me changed by mistake Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
An audit reproduced the double-slash attribute bug on 3.3.12, 3.3.13 and 3.3.14 (the v-for scope is lost; 3.3.14 also narrows to refs) and found it already reported upstream (vuejs/language-tools#6240, fix PR #6357), so nothing is filed. init and doctor now advise 3.3.11, the workspace ranges skip the affected releases, and MIGRATION_V6 and the CLI docs say so. Co-Authored-By: Claude Opus 5.5 <[email protected]>
highlightCriticalPath walks the run back from the root's end through the child that finished last before each point (the Jaeger algorithm) and draws a line under each bar along its stretches on the path; the row says Critical path and the details show a Critical path tag and the time on the path. The details of a span with children also show its self time. New CriticalPath example. Budget-raise: trace 21.1 KB → 21.9 KB (measured 21.84 KB): critical path and self time; the entry measured 21.13 KB before the change. Budget-raise: console-trace-scene 69.35 KB → 70.1 KB (measured 70.09 KB): the scene renders a trace.
An event that carries the spans of its request shows them as a Trace with the critical path between its fields and its JSON, in the side pane and in the drawer, so a slow or failed request leads to the step that held it up without leaving the log. The sample http events carry their request spans.
A View switch (ToggleGroup) in the toolbar, bound to v-model:view, picks how the spans are drawn: waterfall (the default: the tree with a bar per row), timeline (bars only on one axis, each nesting level packed into lanes, a listbox in start order with roving focus) and tree (the nesting with start and duration as text). Search, selection and the details are shared; the zoom applies to the two views with an axis. The events explorer keeps the reader's view across events. New Views example. Budget-raise: trace 21.9 KB → 36.1 KB (measured 36.05 KB): the ToggleGroup view switch; most of it is tailwind-merge through cn, which 51 components already load. Budget-raise: console-trace-scene 70.1 KB → 73.7 KB (measured 73.65 KB): the scene renders a trace. Budget-raise: config-provider 11.25 KB → 11.35 KB (measured 11.31 KB): new trace messages in the English catalog. Budget-raise: locales-pt-BR 10.45 KB → 10.5 KB (measured 10.49 KB): new trace messages. Budget-raise: locales-es 10.6 KB → 10.65 KB (measured 10.62 KB): new trace messages.
Takes the 5.13.0 release: the sticky stack fits the pinned frame and tightens from six claims (FeatureScrollSection drops its 40rem cap and doubled frame rule), artwork tiles draw a registry scene in a 170:128 frame, and pnpm audit ignores picomatch GHSA-fc5q-39xc-vjpf. The branch keeps the image field of the sections for now; removing it as main did is an owner decision for 6.0. css-button rises to 10.85 KB for the settle variants of the decorative loops. Co-Authored-By: Claude Opus 5.5 <[email protected]>
The feature scroll section and the sticky stack fill the pinned frame with one rule at each edge. The register closes B36 and C-11, both stale, and opens OD04 on the image field main removed. Co-Authored-By: Claude Opus 5.5 <[email protected]>
…sal/trace-critical-path
Follows main 5.13.0 (OD04): feature-tiles-section, media-split-section and media-split-stack-section take art from the illustration registry only. tiles[].image and alt, the image prop and MediaSplitSectionImage, and bands[].image, imageAlt and imageFramed are gone with the framed plate. SitePage strips the old fields from stored page data, the product media examples show a Real-Time Metrics scene instead of the G2 badge, and the migration map and guide name the change. BREAKING CHANGE: pass a registry scene name in illustration instead of a picture URL in image on these three sections. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Timeline: bars outside the zoom window leave the keyboard order, Close returns focus to the bar, only bars wide enough carry a label (the rest a title), each nesting level starts with a divider, lanes are 44 px on coarse pointers. The Span header lines up with the names; tree durations use the text danger token; Span stays Span in Spanish and Portuguese. The events explorer wraps its Trace in a bordered div (no style override on the tag) and names retries try 1-3. Spec states, touch target and tokens updated. Views example in TypeScript. Owner decisions TR1-TR4 recorded. Budget-raise: trace 36.1 KB → 36.3 KB (measured 36.21 KB): hidden bars leave the keyboard order and narrow bars carry a title. Budget-raise: console-trace-scene 73.7 KB → 73.9 KB (measured 73.82 KB): the scene renders a trace.
…sal/trace-critical-path # Conflicts: # .claude/docs/DECISIONS.md
…ers and under reduced motion
…titorComparisonSection
…on notes and decisions
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements the spec "Spec final: WebKit pronto para IA" (epic ENG-50003): an AI agent asked for a screen now starts from the WebKit pattern instead of building it from scratch. Open items are in
ROADMAP.md.Code changes (C1–C6)
FieldTextgetstype,autocompleteandspellcheck, andInputTextgetsautocompleteandspellcheck; all of them land on the<input>.spellcheckdefaults to an explicitundefined, and HTML snapshots recorded before the change prove the default output did not change. The newsletter section's e-mail field is now autofillable.no-style-overrideaccepts a static class made only ofw-full,max-w-*,self-*andshrink-0. The list is theLAYOUT_CLASS_FAMILIESexport, which the MCP reads as well.list_tokensinstead ofDESIGN.md. The catalog no longer mentionsDESIGN.md.templates/platform/auth/SignIn,SignUpandCheckInbox. E-mail fields use the new props (autocomplete="username"on sign-in); errors go to oneMessageinside the card, never a toast.accordionandselectmove toimplemented; G3 fails CI on any spec instatus: draft.AI layer
catalog.json#patternsholds 60 patterns generated from the template stories (headers,shells,platform), with intents in English and Portuguese, skills and steps fromparameters.webkit.search_patternsandget_patterntools;suggest_componentreturns the pattern for a screen and the page section for a marketing band; spec status leaves the consumer outputs.catalog:buildfails when an exported component lacks those docs.skills/,rules/andadapters/at the repo root.prepackcopies them into the package, keeping the oldcli-templates/layout for one version.init/syncwrite the block intoAGENTS.mdas well asCLAUDE.md.webkit-page-layoutandwebkit-sections, plus a cross-check with the Web Interface Guidelines.patterns:check: every story has a pattern, intents, real skills and a lint-clean SFC, with legacy debt frozen in a baseline) and G2 (cited-names: skills, rules and patterns only cite exports that exist).DESIGN.mdgets five fixes..claude/launch.jsonand a personal planning draft. Real people's names and e-mails in stories (which become patterns) are replaced with fictional ones.Evaluation (T13)
A clean Vue + Vite app ran
webkit initagainst v5.10.0 and against this branch, and fresh Claude Code sessions got only the request.type="email"+autocomplete="username"on the<input>webkit doctorA second agent (Codex, Cursor) was not available; see ROADMAP item 6.
How to test
pnpm --filter @aziontech/webkit catalog:check,test:toolkit,authoring,doc-standards,test:gate,run spec-status,run patterns:checkandrun cited-namesall pass.pnpm webkit:test: 184 files, 4032 tests passed.pnpm storybook:build,node .claude/hooks/validate-story-source.mjs --all,pnpm --filter @aziontech/webkit run smoke:consumeandnode lint-canaries/index.js(57/57) pass.WEBKIT_CATALOG_PATH=packages/webkit/catalog.json node packages/webkit/src/mcp/server.js, then callsearch_patternswith "login".Notes
.claude/hooks/__tests__/run.mjshas 2 failures that already fail onmain.Size budgets
Budget-raise: css-button 10.75 KB → 10.85 KB (measured 10.77 KB): the theme stylesheet gained the finite settle variants of the decorative loops (WCAG 2.2.2, owner decision on the round-2 audit).
Budget-raise: the console proposals (SchemaForm conditional fields, async options, object arrays, maps, oneOf, formats and sections; the usePlacement scroll check; new locale keys) raised 22 budgets to their measured size. SchemaForm went from 31.35 KB to 50.25 KB because it now renders Combobox, MultiSelect, AttributeEditor, Accordion and PasswordInput. The reasons per entry are in
packages/webkit/docs/reviews/size-budgets-m1.md, table "Console proposals (2026-11-14)".Owner decisions of 2026-11-17 (audit AU1–AU8, register rows A13, A15, B05, B45, C-07, TODAY-clip):
Budget-raise: marquee 7.65 KB → 7.8 KB (measured 7.69 KB): A15 text wordmarks for brands whose terms refuse their logo, in the brand-mark registry (owner 2026-11-17).
Budget-raise: quote-tabs 23.85 KB → 24.05 KB (measured 23.91 KB): A15 text wordmarks for brands whose terms refuse their logo, in the brand-mark registry (owner 2026-11-17).
Budget-raise: client-quotes-section 26.4 KB → 26.6 KB (measured 26.47 KB): A15 text wordmarks for brands whose terms refuse their logo, in the brand-mark registry, through QuoteTabs (owner 2026-11-17).
Budget-raise: doc-markdown 25.9 KB → 26 KB (measured 25.94 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: doc-code-group 32.85 KB → 32.95 KB (measured 32.85 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: article-highlight-section 11.7 KB → 11.8 KB (measured 11.71 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: template-gallery-section 28.35 KB → 28.45 KB (measured 28.37 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: architecture-tabs-section 22 KB → 22.1 KB (measured 22.00 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: locales-es 10.5 KB → 10.6 KB (measured 10.52 KB): the owner decisions of 2026-11-17 (AU1/AU2 field error icon and tokens, AU4 pause messages, C-07 AvatarGroup messages in the shared catalogs) grew it past a budget with no headroom.
Budget-raise: css-button 10.65 KB → 10.75 KB (measured 10.67 KB): the theme stylesheet every app loads gained --text-danger (AU2) and the four diverging chart steps (B05).
Budget-raise: network-section 26.55 KB → 26.65 KB (measured 26.57 KB): the network map packets and PoP pulse now settle within five seconds (WCAG 2.2.2), a finite run per ray.
Budget-raise: logo-wall-section 23.6 KB → 23.7 KB (measured 23.60 KB): the brand text wordmarks (A15) in the shared brand-mark registry.
Budget-raise: doc-page-header 30.6 KB → 30.7 KB (measured 30.62 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: article-body-section 45 KB → 45.1 KB (measured 45.03 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: competitor-comparison-section 24.65 KB → 24.75 KB (measured 24.70 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: plan-comparison-section 37.15 KB → 37.25 KB (measured 37.17 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: timestamp 19.1 KB → 19.25 KB (measured 19.17 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: hotspot 12.9 KB → 13 KB (measured 12.94 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: topology-diagram 27.85 KB → 27.95 KB (measured 27.87 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: overflow-count 14.2 KB → 14.3 KB (measured 14.25 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: table-cell-link 18.95 KB → 19.05 KB (measured 19.01 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: table-cell-tags 15.25 KB → 15.35 KB (measured 15.31 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: filter-menu 35.95 KB → 36.05 KB (measured 35.98 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: filter-menu-root 32.2 KB → 32.3 KB (measured 32.24 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: split-button 15.25 KB → 15.35 KB (measured 15.27 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: breadcrumb 25.3 KB → 25.4 KB (measured 25.32 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: breadcrumb-root 25.25 KB → 25.35 KB (measured 25.29 KB): the shared overlay trigger host now attaches its own click and keydown listeners so a trigger never drops a click made in the mount tick (A13, ROADMAP M2.10 row 73), and the owner decisions of 2026-11-17 grew the shared catalogs.
Budget-raise: doc-frame 5.75 KB → 8.2 KB (measured 8.16 KB): an autoplaying clip now carries a pause control (an
IconButton) and starts itself after mount so it can stay paused under a reduced-motion preference — WCAG 2.2.2, owner decision AU4 (2026-11-17).Budget-raise: locales-pt-BR 10.35 KB → 10.4 KB (measured 10.37 KB): AvatarGroup (C-07) adds its two plural messages to the catalog, which had 15 bytes of headroom.
Budget-raise: console-layout-root 73.3 KB → 73.4 KB (measured 73.35 KB): the compact header keeps a page trail's control crumbs (the environment switch) in place of the brand, owner decision AU5 (2026-11-17).
Budget-raise: console-layout 74.65 KB → 74.75 KB (measured 74.67 KB): the same compact control crumbs, owner decision AU5 (2026-11-17).
Budget-raise: popover 10.8 KB → 10.85 KB (measured 10.82 KB): the shared overlay trigger host attaches its click and keydown listeners natively, so a click fired in the millisecond the trigger mounted is no longer dropped by Vue's listener timestamp guard (M2.10 row 73) (2026-11-17).
Budget-raise: doc-frame 8.2 KB → 8.3 KB (measured 8.26 KB): the autoplay pause control names its clip ("Pause animation: {alt}") so several frames on a page have distinct names (2026-11-17).
Budget-raise: locales-pt-BR 10.4 KB → 10.45 KB (measured 10.42 KB): the catalog adds DocFrame's two named pause and play messages (2026-11-17).
Budget-raise: locales-es 10.5 KB → 10.55 KB (measured 10.54 KB): the same two DocFrame messages (2026-11-17).
Budget-raise: console-trace-scene 67 KB → 68.75 KB (measured 68.64 KB): 6.0 approved proposals merged in v6/prop (Trace minimap zoom, span events and slowest flag).
Budget-raise: trace 18.45 KB → 20.65 KB (measured 20.55 KB): 6.0 approved proposals merged in v6/prop (Trace minimap zoom, span events and slowest flag).
Budget-raise: console-trace-scene 68.75 KB → 69.05 KB (measured 68.94 KB): Roadmap 1 overlays: usePlacement resolves side (start/end), align and sideOffset against the text direction, reached through Tooltip, Popover, HoverCard or the menus.
Budget-raise: trace 20.65 KB → 20.85 KB (measured 20.74 KB): Roadmap 1 overlays: usePlacement resolves side (start/end), align and sideOffset against the text direction, reached through Tooltip, Popover, HoverCard or the menus.
Budget-raise: console-trace-scene 69.05 KB → 69.25 KB (+0.1 to +0.25 KB): copying falls back to a hidden selected field when the clipboard API is missing or refuses (a page served over plain http), so CopyButton and every copy control copy instead of opening the manual-copy popover (utils/clipboard, 2026-11-16).
Budget-raise: trace 20.85 KB → 21.1 KB (+0.1 to +0.25 KB): copying falls back to a hidden selected field when the clipboard API is missing or refuses (a page served over plain http), so CopyButton and every copy control copy instead of opening the manual-copy popover (utils/clipboard, 2026-11-16).
Budget-raise: console-trace-scene 69.25 KB → 69.35 KB (measured 69.31 KB): the review/impeccable fixes and the ai-branch work each grew this entry on their own; merging the two adds both (2026-11-17).
Budget-raise: trace 21.1 KB → 21.9 KB (measured 21.84 KB): the trace draws its critical path under the bars and shows self time and time on the path in the details (
highlightCriticalPath, best-in-class tracing parity); the entry measured 21.13 KB before the change (2026-11-17).Budget-raise: console-trace-scene 69.35 KB → 70.1 KB (measured 70.09 KB): the scene renders a trace, which gained the critical path and self time (2026-11-17).
Budget-raise: trace 21.9 KB → 36.3 KB (measured 36.21 KB): the toolbar holds a
ToggleGroupthat switches the Waterfall, Timeline and Tree views, and the timeline keeps hidden bars out of the keyboard order and labels only bars wide enough (owner request, 2026-11-17). Most of the growth istailwind-merge, whichToggleGroupbrings throughcn; 51 components already importcn(ConsoleLayout and LogViewer among them), so in an app the shared chunk is already loaded and the trace adds about the toggle group's own code.Budget-raise: console-trace-scene 70.1 KB → 73.9 KB (measured 73.82 KB): the scene renders a trace, which gained the view switch (2026-11-17).
Budget-raise: config-provider 11.25 KB → 11.35 KB (measured 11.31 KB): the English catalog it carries gained the trace's view, critical path and self time messages (2026-11-17).
Budget-raise: locales-pt-BR 10.45 KB → 10.5 KB (measured 10.49 KB): the same trace messages (2026-11-17).
Budget-raise: locales-es 10.6 KB → 10.65 KB (measured 10.62 KB): the same trace messages (2026-11-17).
🤖 Generated with Claude Code