API reference

known_issues.md · Known limitations · 4/5

Browse entries grouped by interface file. Expand an entry for declarations, usage and version boundaries.

Read the related guide →

Entries retain declarations and sources. Runtime verification is recorded per entry; internal source candidates are not a promise of SDK delivery.

docs/known_issues.md
T-DEBT-PERF-EVIDENCE-PATH-HEADROOM
Known issue3.61.7C++

Experiment evidence paths have only 19 characters of headroom in the default output directory

Verification scope

docs/known_issues.md:240

Report an issue with this entry →
T-DEBT-POSIX-LSP-EXEC-MISSING-DETECTION
Known issue3.61.7C++

Detect missing POSIX LSP executables

Verification scope

docs/known_issues.md:382

Report an issue with this entry →
T-DEBT-PRE-BLOCK-ANONYMOUS-IFC
Known issue3.61.7C++

Unify anonymous IFCs and preserved line breaks around block siblings in <pre>, pre-wrap, and break-spaces

Verification scope

docs/known_issues.md:146

Report an issue with this entry →
T-DEBT-PRE-WRAP-JUSTIFY-PRESERVED-SPACES
Known issue3.61.7C++

Keep justification opportunities, block height, and source mapping consistent for consecutive preserved spaces under pre-wrap + justify

Verification scope

docs/known_issues.md:147

Report an issue with this entry →
T-DEBT-RAW-FONT-PATH-FAMILY-TABLE
Known issue3.61.7C++

The raw SkFont measurement path still maintains a third font-family table, with fallback glyphs differing from the paragraph path

Verification scope

docs/known_issues.md:264

Report an issue with this entry →
T-DEBT-REAL-APP-CORPUS-COVERAGE-GAPS
Known issue3.61.7C++

Real-app corpus has three gaps: Lua-generated content lacks Chrome comparisons, performance pages include the loader navigation bar, and forge-ims is absent

Verification scope

docs/known_issues.md:360

Report an issue with this entry →
T-DEBT-RELAB-FIRST-PLAY-MAX-FRAME-NOISE
Known issue3.61.7C++

The alternating previous-release comparison uses first-play maximum animation frame time as a blocking metric with thresholds narrower than same-build noise, causing false failures

Verification scope

docs/known_issues.md:361

Report an issue with this entry →
T-DEBT-REPLACED-BLOCK-INTRINSIC-KEYWORD-CONSTRAINT
Known issue3.61.7C++

Block-axis min/max intrinsic keyword constraints on replaced images do not transfer the natural ratio from a definite width

Verification scope

docs/known_issues.md:111

Report an issue with this entry →
T-DEBT-REPLACED-INTRINSIC-SIZING-PARITY
Known issue3.61.7C++

The main replaced-element sizing path is fixed; remaining work is limited to unifying unloaded-image paths and NativeGui iframe default-border conventions

Verification scope

docs/known_issues.md:110

Report an issue with this entry →
T-DEBT-RTL-ELLIPSIS-VISUAL-END
Known issue3.61.7C++

When LTR content overflows a direction:rtl paragraph, text-overflow removes the logical tail instead of the part crossing the visual line-end edge

Verification scope

docs/known_issues.md:190

Report an issue with this entry →
T-DEBT-RTL-HANGING-WHITESPACE-AT-VISUAL-END
Known issue3.61.7C++

An inline wrapping text and preserved trailing spaces in an RTL pre-wrap paragraph lacks a fragment painted at the visual line end

Verification scope

docs/known_issues.md:339

Report an issue with this entry →
T-DEBT-RTL-NATIVE-ELLIPSIS-INLINE-DECORATION-EXTENT
Known issue3.61.7C++

When a native ellipsis in legacy RTL line-clamp lands at the truncation point of an inline with background/borders, its decoration area does not exclude the ellipsis

Verification scope

docs/known_issues.md:209

Report an issue with this entry →
T-DEBT-RTL-PLACEHOLDER-REORDER-INDEX-QUERIES
Known issue3.61.7C++

UTF-16-indexed placeholder rectangle queries in bidi-reordered lines return another atomic box or margin slot, affecting selection highlights and caret hit testing

Verification scope

docs/known_issues.md:333

Report an issue with this entry →
T-DEBT-RTL-STATIC-POSITION-ALIGNMENT
Known issue3.61.7C++

Absolute static-position, self-alignment, and Flex/Grid alignment support under RTL and logical directions

Verification scope

docs/known_issues.md:116

Report an issue with this entry →
T-DEBT-SCOPE-FLAGS-ARE-DECLARATIVE-ONLY
Known issue3.61.7C++

KUI_DISABLE_MULTICOL, KUI_DISABLE_SHAPES, and KUI_DISABLE_SUBGRID are never read by code, although config.h claims NOT COMPILED IN and its code paths are gated out

Verification scope

docs/known_issues.md:286

Report an issue with this entry →
T-DEBT-SCOPE-FRAGMENTATION-FLEX-GRID-TABLE
Known issue3.61.7C++

Pagination fragmentation for Flex, Grid, and Table is not implemented

Verification scope

docs/known_issues.md:126

Report an issue with this entry →
T-DEBT-SCOPE-REOPEN-MULTICOL-SHAPES-SUBGRID
Known issue3.61.7C++

Reclassify compile-time-disabled multicol, CSS Shapes, and subgrid from out of scope to unimplemented and awaiting scheduling

Verification scope

docs/known_issues.md:125

Report an issue with this entry →
T-DEBT-SCROLL-ANCHORING-SPEC-GAPS
Known issue3.61.7C++

Remaining differences between scroll anchoring and CSS Scroll Anchoring/Chrome

Verification scope

docs/known_issues.md:124

Report an issue with this entry →
T-DEBT-SCROLL-CONTAINER-FIRST-BASELINE-GATED
Known issue3.61.7C++

An overflow gate suppresses scroll-container first baselines, causing flex/grid baseline alignment to use the wrong line

Verification scope

docs/known_issues.md:119

Report an issue with this entry →
T-DEBT-SCROLL-OFFSET-DEVICE-PIXEL-SNAP
Known issue3.61.7C++

Scroll offsets do not snap to device pixels: scrollTop/scrollLeft may be arbitrary fractions, and at the bottom of fractional layouts scrollTop + clientHeight falls short of scrollHeight by less than 1 px

Verification scope

docs/known_issues.md:277

Report an issue with this entry →
T-DEBT-SDK-C-PACKAGE-PLATFORM-PARITY
Known issue3.61.7C++

Bring C SDK packaging into alignment across platforms

Verification scope

docs/known_issues.md:377

Report an issue with this entry →
T-DEBT-SDK-EXAMPLES-GATE-USES-INTREE-FLAG
Known issue3.61.7C++

Decouple the SDK example gate from the legacy in-tree 3D switch

Verification scope

docs/known_issues.md:378

Report an issue with this entry →
T-DEBT-SDK-EXT-DLL-NO-VERSION-RESOURCE
Known issue3.61.7C++

Extension and media-backend DLLs still lack VS_VERSION_INFO and a build ID

Verification scope

docs/known_issues.md:287

Report an issue with this entry →
T-DEBT-SEGMENT-IFC-NO-PER-LINE-FLOAT-EXCLUSION
Known issue3.61.7C++

The block-stacking loop lays out inline content on either side of a float separately, placing preceding text and following inline elements on different lines

Verification scope

docs/known_issues.md:120

Report an issue with this entry →
T-DEBT-SEGMENT-INLINE-ROOT-LINE-RELATIVE-ATOMIC
Known issue3.61.7C++

In segmented inline layout, top/bottom-aligned atomic boxes inside a span align to the span paragraph line rather than the outer line

Verification scope

docs/known_issues.md:329

Report an issue with this entry →
T-DEBT-SELECT-ENHANCE
Known issue3.61.7C++

Remaining selective-layout improvements

Verification scope

docs/known_issues.md:219

Report an issue with this entry →
T-DEBT-SELECTION-LINE-END-HIGHLIGHT-PARITY
Known issue3.61.7C++

Line-end/block-end newline highlights on intermediate lines of a multiline selection differ from Chrome by about one space width

Verification scope

docs/known_issues.md:368

Report an issue with this entry →
T-DEBT-SELECTIVE-INLINE-TABLE-OOF-ONLY-CHILD-LINE-HEIGHT
Known issue3.61.7C++

Changing the only display:table-cell child of a display:inline-table to position:absolute increases line height by 8px on the incremental path

Verification scope

docs/known_issues.md:347

Report an issue with this entry →
T-DEBT-SELF-OVERFLOW-MODIFIER-ITEMS-PARITY
Known issue3.61.7C++

Items do not yet preserve the unsafe modifier or propagate auto self values; non-abspos physical modifier combinations continue to use legacy values

Verification scope

docs/known_issues.md:128

Report an issue with this entry →
T-DEBT-SKIA-CPU-OPTS-NON-WINDOWS-UNVERIFIED
Known issue3.61.7C++

Skia runtime CPU dispatch (SkGraphics::Init()) remains disabled on Linux/macOS pending local pixel validation

Verification scope

docs/known_issues.md:393

Report an issue with this entry →
T-DEBT-SKPARAGRAPH-CROSS-BLOCK-SHAPING-CONTEXT
Known issue3.61.7C++

SkParagraph shapes each font run without surrounding context; joining text across fonts or formatting relies on an incomplete presentation-form compatibility layer

Verification scope

docs/known_issues.md:266

Report an issue with this entry →
T-DEBT-SKPARAGRAPH-ELLIPSIS-GHOST-SPACE-OFFSET
Known issue3.61.7C++

Trailing hanging-whitespace offset in native line-clamp ellipses, with the remaining boundary narrowed

Verification scope

docs/known_issues.md:200

Report an issue with this entry →
T-DEBT-SKPARAGRAPH-LINE-ROUNDING-EATS-ATOMIC-ASCENT
Known issue3.61.7C++

SkParagraph assigns line-height rounding fractions to the ascent, letting atomic boxes taller than the text extend up to 0.5px above the line

Verification scope

docs/known_issues.md:328

Report an issue with this entry →
T-DEBT-SOFT-WRAP-LEFT-ALIGN-CEIL-PARITY
Known issue3.61.7C++

Physically left-aligned paragraphs round soft-wrap widths up to whole pixels, fitting one more word than Chrome at fractional widths

Verification scope

docs/known_issues.md:161

Report an issue with this entry →
T-DEBT-STYLE-MEMCMP-PADDING
Known issue3.61.7C++

The memcmp fast path in ComputedStyle::operator== can be misled by residual bytes in alignment padding

Verification scope

docs/known_issues.md:270

Report an issue with this entry →
T-DEBT-SUPPORTS-NESTED-GENERAL-ENCLOSED
Known issue3.61.7C++

Nested @supports parentheses that contain neither a declaration nor a valid condition are treated as invalid, although the specification requires general-enclosed with a false result

Verification scope

docs/known_issues.md:281

Report an issue with this entry →
T-DEBT-TABLE-CELL-BASELINE-SKIPS-BLOCK-DESCENDANTS
Known issue3.61.7C++

A table cell first-baseline query does not descend into line boxes inside block children

Verification scope

docs/known_issues.md:86

Report an issue with this entry →
T-DEBT-TABLE-CELL-INTRINSIC-KNOWN-BOX-SNAPSHOTS
Known issue3.61.7C++

The 45 known differing boxes in the C2 candidate guard temporarily use separate exact KUI snapshots

Verification scope

docs/known_issues.md:94

Report an issue with this entry →
T-DEBT-TABLE-CELL-INTRINSIC-LEGACY-FALLBACK
Known issue3.61.7C++

C2 unified candidate-content measurement still uses trial layout at non-atomic inline and nested CSS direct-cell boundaries

Verification scope

docs/known_issues.md:93

Report an issue with this entry →
T-DEBT-TABLE-FLOAT-FORCED-BREAKS
Known issue3.61.7C++

Spans laid out segment by segment beside floats lose br breaks and collapse multiline content into one line, including outside tables

Verification scope

docs/known_issues.md:96

Report an issue with this entry →
T-DEBT-TABLE-NATURAL-MINIMUM-LOST-IN-ROW-FLEX-CONTRIBUTION
Known issue3.61.7C++

Row flex container intrinsic contributions lose the natural minimum width of a table

Verification scope

docs/known_issues.md:64

Report an issue with this entry →
T-DEBT-TABLE-WRAPPER-INTRINSIC-WHOLE-PIXEL-CEIL
Known issue3.61.7C++

The shrink-to-fit outer frame of an inline-block wrapping a table is still rounded up to whole pixels

Verification scope

docs/known_issues.md:95

Report an issue with this entry →
T-DEBT-TEST-DEVTOOLS-SERVER-PORT-NO-RETRY
Known issue3.61.7C++

test_devtools_server fails without retry when its chosen port is already in use

Verification scope

docs/known_issues.md:396

Report an issue with this entry →
T-DEBT-TEST-VSYNC-IMAGE-LOAD-GATE-WARMUP-FLAKY
Known issue3.61.7C++

VsyncFrameGateWindow.ImageLoadStartedWhileGatedShowsPromptly intermittently fails its warmup assertion during parallel full-suite runs

Verification scope

docs/known_issues.md:399

Report an issue with this entry →
T-DEBT-TEST-VSYNC-LOTTIE-OVERSHOOT-P90-FLAKY
Known issue3.61.7C++

VsyncFrameGateWindow.LottieOnlyPostsAroundFrameChanges intermittently exceeds p90 tolerance during parallel full-suite runs

Verification scope

docs/known_issues.md:398

Report an issue with this entry →
T-DEBT-TEST-WALLCLOCK-ANIMATION-SAMPLING-NOT-DETERMINISTIC
Known issue3.61.7C++

Animation/performance tests sample wall-clock time; frame-count and duration assumptions fail in unoptimized Debug builds

Verification scope

docs/known_issues.md:395

Report an issue with this entry →
T-DEBT-TEST-WINFORMS-ROUNDED-SHADOW-LAYER-REUSE-FLAKY
Known issue3.61.7C++

Win32WindowFeedback.RoundedShadowLayerCompositeUpdatesAllCorners intermittently reports layerRootReuses == 0

Verification scope

docs/known_issues.md:397

Report an issue with this entry →
T-DEBT-TEXT-ALIGN-LAST-LINE
Known issue3.61.7C++

Last-line detection, logical alignment, and justification for text-align-last

Verification scope

docs/known_issues.md:149

Report an issue with this entry →
T-DEBT-TEXT-DECORATION-SKIP-SPACES-PROPERTY
Known issue3.61.7C++

text-decoration-skip-spaces is unimplemented and the set of skipped whitespace differs from the specification

Verification scope

docs/known_issues.md:364

Report an issue with this entry →
T-DEBT-TEXT-INDENT-GLUE-RESIDUAL-SHAPES
Known issue3.61.7C++

Shapes not covered by the text-indent glue carrier, including a break after the indent when the first word does not fit

Verification scope

docs/known_issues.md:179

Report an issue with this entry →
T-DEBT-TEXT-MARKER-PARAGRAPH-PHASE
Known issue3.61.7C++

Text list markers, including decimal numbering and ::marker content, still use paragraph painting phase and differ from Chrome when the first-line baseline is not on the strut

Verification scope

docs/known_issues.md:216

Report an issue with this entry →
T-DEBT-TEXT-UNDERLINE-POSITION-UNDER
Known issue3.61.7C++

text-underline-position recognizes only auto and from-font; under, left and right are ignored

Verification scope

docs/known_issues.md:330

Report an issue with this entry →
T-DEBT-TRANSFORM-TRANSITION-MIXED-UNIT-TRANSLATE-DISCRETE
Known issue3.61.7C++

A transform-transition translate component switches discretely halfway when one endpoint is nonzero px and the other is a nonzero percentage

Verification scope

docs/known_issues.md:363

Report an issue with this entry →
T-DEBT-UA-BLOCKIFIED-BUTTON-INTRINSIC
Known issue3.61.7C++

Establish an intrinsic-sizing matrix for BrowserCompat blockified/semi-replaced buttons

Verification scope

docs/known_issues.md:137

Report an issue with this entry →
T-DEBT-UA-FORM-CONTROL-BASELINE-MATRIX
Known issue3.61.7C++

Establish an intrinsic-height, baseline, and line-box matrix for all BrowserCompat controls

Verification scope

docs/known_issues.md:138

Report an issue with this entry →
T-DEBT-UA-NATIVE-MATRIX-LINUX-MACOS
Known issue3.61.7C++

Build a BrowserCompat native-control geometry matrix for Linux and macOS

Verification scope

docs/known_issues.md:285

Report an issue with this entry →
T-DEBT-VERTICAL-ALIGN-WRAPPED-EDGE-TEXT-SPAN
Known issue3.61.7C++

Wrapped text spans with vertical-align:top/bottom differ from Chrome in position and line-box height

Verification scope

docs/known_issues.md:334

Report an issue with this entry →
T-DEBT-VISUAL-TEST-OUTPUT-TRACKED
Known issue3.61.7C++

Running all ordinary tests overwrites tracked tests/visual/output/typography_actual.png and typography_diff.png

Verification scope

docs/known_issues.md:391

Report an issue with this entry →
T-DEBT-WHITESPACE-PRESERVED-TRAILING-GEOMETRY
Known issue3.61.7C++

Consistency of trailing-space advances, wrap ownership, line boxes, and painting in pre-wrap/break-spaces

Verification scope

docs/known_issues.md:178

Report an issue with this entry →
T-DEBT-WINDOW-GPU-TEARDOWN-LINUX-MACOS
Known issue3.61.7C++

Destroying a Window on Linux/macOS does not release GPU resources either: GLX contexts, Metal devices, and GrDirectContext remain until the thread exits

Verification scope

docs/known_issues.md:291

Report an issue with this entry →
T-DEBT-WINDOWS-LCD-PARAGRAPH-ELIGIBILITY-STABILITY
Known issue3.61.7C++

Stabilize Windows LCD paragraph eligibility and capture phase

Verification scope

docs/known_issues.md:261

Report an issue with this entry →
T-DEBT-WINDOWS-NORMAL-LINE-COMPONENTS-NOT-ROUNDED-LIKE-CHROME
Known issue3.61.7C++

On Windows, normal-line strut ascent/descent and text baselines inside atomic boxes retain fractions, with whole-line rounding used to match Chrome integer line heights

Verification scope

docs/known_issues.md:177

Report an issue with this entry →
T-DEBT-WORD-GUARD-NON-UAX14-SEGMENTS
Known issue3.61.7C++

Whole-word protection splits on whitespace and ASCII punctuation, so segments with other break opportunities, including ideographs, hyphens, slashes, and Thai, are protected as a whole or split incorrectly

Verification scope

docs/known_issues.md:159

Report an issue with this entry →
T-DEBT-WPT-BLOCK-IN-INLINE-GENERATED-QUOTE-OFFSET
Known issue3.61.7C++

Align the generated-content inline start in a leading block-in-inline fragment

Verification scope

docs/known_issues.md:145

Report an issue with this entry →
T-DEBT-WPT-LINE-CLAMP-036-CHROME-DISAGREES
Known issue3.61.7C++

When the first word does not fit on the final line with text-overflow:ellipsis and legacy line-clamp, KUI retains the WPT webkit_line_clamp_036/F-WPT-FIX-924 behavior of falling back to a soft-wrap opportunity and leaving only an ellipsis, while Chrome 153 on the same machine truncates by grapheme, as in supercali followed by an ellipsis

Verification scope

docs/known_issues.md:205

Report an issue with this entry →
T-DEBT-WPT-MIXED-FONT-NORMAL-LINEBOX-UNION
Known issue3.61.7C++

Unify line-height:normal union rounding for mixed custom/fallback fonts and split inlines

Verification scope

docs/known_issues.md:144

Report an issue with this entry →
T-DEBT-WPT-SIZE-ADJUST-FALLBACK-FRACTIONAL-PHASE
Known issue3.61.7C++

Resolve fractional-phase and baseline behavior for font-size-adjust with unicode-range and system fallback

Verification scope

docs/known_issues.md:260

Report an issue with this entry →
T-DOC-KNOWN-CHROME-DIFFS-REGISTRY
Known issue3.61.7C++

Register known differences from Chrome that have not met the issue-registration threshold; 34 old T-BUG entries have been moved out of this table

Verification scope

docs/known_issues.md:392

Report an issue with this entry →
T-PERF-BREAK-SPACES-FORCED-BOUNDARY-RELAYOUT
Known issue3.61.7C++

Width-dependent break-spaces corrections relayout the entire paragraph for each forced break; the same path also searches U+2028 correction fragments code point by code point for same-line membership

Verification scope

docs/known_issues.md:354

Report an issue with this entry →
T-PERF-CPU-MIX-BLEND-FALLBACK-SUBTREES
Known issue3.61.7C++

CPU blend-layer fallback cases (DstIn, masks, filters, shadows, non-translation text, wavy lines, and unknown operations), GPU, and PDF still use full-size large layers

Verification scope

docs/known_issues.md:232

Report an issue with this entry →
T-PERF-DL-PER-BOX-SAVE-RESTORE-OPS
Known issue3.61.7C++

Every box adds save/translate/restore operations to the display list even if it paints nothing

Verification scope

docs/known_issues.md:356

Report an issue with this entry →
T-PERF-EVAL-APP-SHELL-EXPERIMENTS
Known issue3.61.7C++

The performance experiment matrix lacks realistic application structures and budgets independent of scale

Verification scope

docs/known_issues.md:239

Report an issue with this entry →
T-PERF-EVAL-CONSUMER-INTERACTION-TRACES
Known issue3.61.7C++

Consumer projects participate only in SDK release verification and do not collect interaction performance traces

Verification scope

docs/known_issues.md:242

Report an issue with this entry →
T-PERF-EVAL-GENERATIVE-STRUCTURES
Known issue3.61.7C++

Automatically find cases where one dirty box causes workload to grow with scale by generating combined structures

Verification scope

docs/known_issues.md:241

Report an issue with this entry →
T-PERF-FIRST-OPEN-COMPOSITE-SPIKE
Known issue3.61.7C++

Opening a small overlay or form for the first time adds 6-9 ms of compositing time

Verification scope

docs/known_issues.md:229

Report an issue with this entry →
T-PERF-FIXED-ROOT-NOT-DAMAGE-CULLED
Known issue3.61.7C++

Fixed-position elements bypass damage culling; visible-overflow containers still record their own backgrounds and borders outside the damage region

Verification scope

docs/known_issues.md:357

Report an issue with this entry →
T-PERF-GPU-PARTIAL-REPLAY-FIRST-FRAME-OVERHEAD
Known issue3.61.7C++

On the GPU, the first partial replay frame with many opacity layers still costs about 5ms more than a full repaint

Verification scope

docs/known_issues.md:349

Report an issue with this entry →
T-PERF-IFC-FLOAT-GAP-DOUBLE-LAYOUT
Known issue3.61.7C++

Paragraphs beside floats are laid out at full width first, then laid out again at the available gap width once stability is established

Verification scope

docs/known_issues.md:348

Report an issue with this entry →
T-PERF-LINE-CLAMP-SOFT-LINE-ELLIPSIS-WIDTH-CHANGE-PROBE
Known issue3.61.7C++

Changing the width every frame with legacy soft-line clamping adds line-end probes and paint reconstruction work

Verification scope

docs/known_issues.md:223

Report an issue with this entry →
T-PERF-LUA-OFFSCREEN-CANVAS-RGBA-SURFACE
Known issue3.61.7C++

Some Lua OffscreenCanvas drawing operations still use the slow general RGBA raster pipeline

Verification scope

docs/known_issues.md:233

Report an issue with this entry →
Browse this reference type →