Files
multica/packages/views/editor/styles/mermaid.css
Jiayuan Zhang 7803a5b9ea feat(ui): establish a role-named type scale and migrate ad-hoc font sizes (MUL-5451) (#6136)
tokens.css defined colours, radii and font families but not a single --text-*
step, so font sizes had no baseline to align to and grew wherever they were
needed: 51 distinct sizes across web + desktop, 370 written as arbitrary
values, six at half a pixel (10.5 / 11.5 / 12.5 / 13.5 / 14.5 / 15.5px).
text-xs and text-sm carried nearly all UI text while the range between them —
11, 13, 15px — could only be reached with arbitrary values. Hierarchy does not
come from having more sizes; past a handful, each extra size makes the
hierarchy blurrier.

Add ten role-named steps, each with its own line-height so leading cannot
fragment the way size did, and move every product-UI call site onto them.
Steps are named for what the text is for, not for a t-shirt size, because
that is what keeps the scale from drifting again.

Six steps deliberately keep the exact size/line-height pairs of the Tailwind
defaults they replace, so the ~1,900-call-site rename moves nothing on screen.
The visible changes are confined to former arbitrary values snapping to a step:
8/9/10px -> micro (11px) on badges and overlines; 17 -> 18; 22 -> 24; 30
(text-3xl) -> 36 on headings and stat numbers; 12.8px -> label (13px) on small
buttons and toggles. Half-pixel sizes are gone.

This supersedes #6108, which was reverted by #6116 because the sidebar group
labels rendered at the inherited 16px. The cause was not the scale but cn():
`text-<x>` is ambiguous in Tailwind, and tailwind-merge resolves it against a
table listing only the default sizes, so it filed every role step under
text-colour and dropped whichever of `text-caption` /
`text-sidebar-foreground/70` came first. Registering the steps as a font-size
class group restores the real conflict groups — size beats size, colour beats
colour, the two coexist — and a test pins the list against the scale, since
the failure is silent in source.

Hand-written CSS is covered too. The transcript kept a 12.5px body long after
every Tailwind call site was on the scale, so the "no half-pixel sizes" claim
was true of the classes and false of the product; the editor's prose, code and
mermaid ramps had the same blind spot, and seven of their eight values already
equalled a step exactly. All now reference var(--text-*). The guard test reads
raw `font-size:` declarations as well as class names, exempting only the 16px
iOS input-zoom workaround in base.css and the landing pages' marketing ramp.

apps/mobile (own NativeWind config) and apps/docs (fumadocs' own type system)
keep Tailwind's default scale and are untouched. Landing display type
(rem/clamp, 2.2-6.4rem) stays on its separate ramp, as do four decorative
emoji / serif-hero sizes.

Verified on a running local stack: pinned sidebar rows and group labels
measure 12px/16px, nav items 14px/20px — identical to pre-migration. An audit
of every rendered font size across the product surfaces finds nothing off the
scale; the only exceptions are avatar initials and emoji, which
actor-avatar.tsx sizes proportionally to the avatar diameter by design.

Co-authored-by: Lambda <lambda@multica.ai>
Co-authored-by: multica-agent <github@multica.ai>
2026-07-30 13:42:33 +08:00

177 lines
5.3 KiB
CSS

/* Mermaid diagrams */
/* The outer container does NOT scroll — `.mermaid-diagram-scroll` inside it
does. That split is what keeps the toolbar pinned: when the container itself
was the scroller, the absolutely-positioned toolbar scrolled away with wide
diagrams and left no visible way to open or copy them. */
.rich-text-editor .mermaid-diagram {
background: var(--muted);
border: 1px solid var(--border);
border-radius: var(--radius);
margin: 0.75rem 0;
overflow: hidden;
padding: 1rem;
position: relative;
}
.rich-text-editor .mermaid-diagram-scroll {
display: flex;
/* Small diagrams sit centered at natural size; only oversized ones scroll.
Upscaling a small diagram to fill the column would just coarsen it. */
justify-content: center;
overflow-x: auto;
overflow-y: hidden;
cursor: zoom-in;
/* Dragging a diagram would otherwise start a native text selection: the
iframe is a replaced element, so the whole diagram box gets painted with
the selection highlight, and the drag runs on into the surrounding
comment text. Selecting prose *through* the diagram still works — this
only stops a selection from starting on the diagram itself. */
user-select: none;
}
.rich-text-editor .mermaid-diagram-frame {
border: 0;
display: block;
/* Natural width, never shrunk to the column: a wide diagram must keep a
readable font size and scroll sideways instead of being squashed until the
labels are unreadable. `flex: none` stops the flex parent from shrinking
it; a `max-width` here would defeat the scroll entirely. */
flex: none;
/* The iframe cannot forward clicks to this document, so it would swallow
the click-to-open gesture. Disabling pointer events hands wheel, click,
and drag to the scroll container instead. */
pointer-events: none;
}
/* Edge fades: a hint that the diagram continues past the container. Driven by
data attributes the component sets from scroll position, so a diagram that
fits shows no fade, and a scrolled-to-the-end one fades only on the left. */
.rich-text-editor .mermaid-diagram::before,
.rich-text-editor .mermaid-diagram::after {
content: "";
position: absolute;
top: 0;
bottom: 0;
width: 2rem;
pointer-events: none;
opacity: 0;
transition: opacity 0.15s;
z-index: 1;
}
.rich-text-editor .mermaid-diagram::before {
left: 0;
background: linear-gradient(to right, var(--muted), transparent);
}
.rich-text-editor .mermaid-diagram::after {
right: 0;
background: linear-gradient(to left, var(--muted), transparent);
}
.rich-text-editor .mermaid-diagram[data-overflow-start]::before,
.rich-text-editor .mermaid-diagram[data-overflow-end]::after {
opacity: 1;
}
.rich-text-editor .mermaid-diagram-loading,
.rich-text-editor .mermaid-diagram-error p {
color: var(--muted-foreground);
font-size: var(--text-label);
margin: 0;
}
.rich-text-editor .mermaid-diagram-error-head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.5rem;
}
.rich-text-editor .mermaid-diagram-error-head button {
display: flex;
align-items: center;
justify-content: center;
width: 1.75rem;
height: 1.75rem;
border-radius: calc(var(--radius) - 2px);
color: var(--muted-foreground);
flex: none;
}
.rich-text-editor .mermaid-diagram-error-head button:hover {
background: var(--secondary);
color: var(--foreground);
}
.rich-text-editor .mermaid-diagram-error-detail {
font-family: var(--font-mono, monospace);
font-size: var(--text-caption);
margin: 0.375rem 0 0;
white-space: pre-wrap;
word-break: break-word;
}
/* The error state has no inner scroller, and the container clips; without its
own overflow a long source line would be cut off with no way to read it. */
.rich-text-editor .mermaid-diagram-error pre {
margin-bottom: 0;
overflow-x: auto;
}
/* Mermaid toolbar — dark pill, top-right corner */
.rich-text-editor .mermaid-diagram-toolbar {
position: absolute;
top: 0.5rem;
right: 0.5rem;
display: flex;
gap: 1px;
padding: 0.25rem;
background: color-mix(in srgb, black 75%, transparent);
backdrop-filter: blur(8px);
border-radius: var(--radius);
transition: opacity 0.15s;
z-index: 2;
}
/* Reveal-on-hover only where hovering exists. On touch there is no hover
state to enter, so the toolbar would have been permanently invisible and
the diagram effectively un-openable. */
@media (hover: hover) {
.rich-text-editor .mermaid-diagram-toolbar {
opacity: 0;
}
.rich-text-editor .mermaid-diagram:hover .mermaid-diagram-toolbar,
.rich-text-editor .mermaid-diagram-toolbar:focus-within {
opacity: 1;
}
}
.rich-text-editor .mermaid-diagram-toolbar button {
display: flex;
align-items: center;
justify-content: center;
width: 1.75rem;
height: 1.75rem;
border-radius: calc(var(--radius) - 2px);
color: white;
transition: background 0.15s;
}
.rich-text-editor .mermaid-diagram-toolbar button:hover {
background: color-mix(in srgb, white 15%, transparent);
}
/* Full-screen viewer frame. The canvas that pans/zooms it is shared with the
image preview and lives in ./zoom-canvas.css. */
.mermaid-viewer-frame {
border: 0;
display: block;
background: transparent;
/* Same reason as the inline frame: interaction is owned by the canvas in
this document, so the sandbox never has to be relaxed to allow zooming. */
pointer-events: none;
}