Skip to content

Commit 889c365

Browse files
1aronclaude
andcommitted
Chore(Agent): Sync Master Design 0.3.7 through internal-skills 0.1.11
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 69f8ef0 commit 889c365

8 files changed

Lines changed: 38 additions & 16 deletions

File tree

‎.agents/skills/.master-lock.json‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
"sources": {
33
"master-design": {
44
"repository": "https://github.com/master-co/design",
5-
"sourceVersion": "0.3.6",
6-
"sourceCommit": "458b38c75f1df3d983bf896844c63e778c61a36f",
5+
"sourceVersion": "0.3.7",
6+
"sourceCommit": "56bb59f73de8208ea46f54c543acbfbc7f25148f",
77
"sourceDirectory": "skills/master-design",
8-
"snapshot": "529f44e3d629f2676b2698f678d72bcacea865a9ce18fff61e6cba99da2aebe3"
8+
"snapshot": "d18186602fbeff7dd36178f20add1105d569e1f3ebbdacd27230a4dd3a779c90"
99
}
1010
},
1111
"schema": 1,
1212
"package": "@master/internal-skills",
13-
"version": "0.1.10",
13+
"version": "0.1.11",
1414
"skills": [
1515
"master-design",
1616
"master-site",
@@ -44,9 +44,9 @@
4444
"master-design/references/foundations/sizing.md": "3af35c66ae985f115ecec0d87b91c9addf11b1a697d6c6be5577cf1c9d8ba207",
4545
"master-design/references/foundations/spacing.md": "7336829411d57c8c51c419c34f9aeab628a87a17ece771f7a20f1460c2dcadaa",
4646
"master-design/references/foundations/typography.md": "7c3fe6a160f8828a37dca0d2f6769cf96d3ef872e4e54e708e60a28d2c0d03c4",
47-
"master-design/references/geometry.md": "991e5df416bcf5a8192c8ee7599aa22694fbf6cacf6b0346d3e52f2d6b536f6f",
47+
"master-design/references/geometry.md": "cb6d153f4607d823872e139f61f51d9e7424cbb934ab81106dd3d25662502675",
4848
"master-design/references/images.md": "b44415c945345d38001bf84de6ae9364c128e53b9ca4e2481b47d053322077f0",
49-
"master-design/references/layout.md": "bc53a875c84a112f5e6dc20cc96f785a21a3fa912e202facb0b10ea63e321891",
49+
"master-design/references/layout.md": "f6eb863c815ed91954c262fe98512f33fa7552e8d93fbf8b379d97fb44f45e59",
5050
"master-design/references/materials.md": "556562483c0db6b7d653d039f1045a388387c31a1855e2eaa93071e033fa88c3",
5151
"master-design/references/motion.md": "6ab930899324b0e7157e79c78f6f73b48d5dc1aea6aa69f2b93191f67ae864b7",
5252
"master-design/references/overview.md": "43beaa5484865664fef18ce37b72fd04e63a70f863f712a34c9dc1b55e870b82",
@@ -75,8 +75,8 @@
7575
"master-design/references/studies/service.md": "55970aa14cfa6ba975d3fae11e7d10b23d6f68044a5c98b94ddff007713cbbd6",
7676
"master-design/references/studies/workspace.md": "17fbd95d788c1ffaa1c0a0f02345dae7cd414a3431588c8693ff7895d1219f1f",
7777
"master-design/references/surfaces.md": "79c09f5b0d36ffe818e3ae6348c8ec96c826098a55cfd5dff463d6f8597d6c70",
78-
"master-design/references/typography.md": "7b3a18dc0dc3794a0d4bd0ffd72177a470db11785c1bf5560a3337f895e1446f",
79-
"master-design/SKILL.md": "43191d9938e035fd33b24aba7ee0ff27b56130b403a2c85ce2ab57a9db8d7b27",
78+
"master-design/references/typography.md": "f495c69d07bfc32530c328ff3ab4f0e02d54389d5ddbecf2a4c38feac2bc22c2",
79+
"master-design/SKILL.md": "88601a8455d42441c011272570551305389e11403d143ec5c20c46ad6ba96d5e",
8080
"master-site/SKILL.md": "ddb5888aece02e6ac34fe1d4762df1a2d2d19945fbaba2722e0f8e0d6b247f6c",
8181
"master-writing/references/document-components.md": "9c576a83d64c8e3c32a73d77d48d18a2d29cc64ad050ffbe21033d6b873486c4",
8282
"master-writing/references/style.md": "60f194f3b6c0be1feae0078916c97cdc7036914ca2551d9195a8e3e0608d32a4",

‎.agents/skills/master-design/SKILL.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Design and refine web interfaces: principles, foundations, accessi
44
license: MIT
55
metadata:
66
author: master-co
7-
version: "0.3.6"
7+
version: "0.3.7"
88
---
99

1010
# Master Design
@@ -44,10 +44,10 @@ Use these craft references when the visible mechanism needs closer inspection:
4444
| Work | Reference |
4545
| --- | --- |
4646
| Rings, hairlines, layered shadows, dark surfaces and textures | [Surfaces](references/surfaces.md) |
47-
| Insets, painted boundaries, nested and continuous corners | [Geometry](references/geometry.md) |
47+
| Insets, painted boundaries, end controls, nested and continuous corners | [Geometry](references/geometry.md) |
4848
| Image outlines, crop, container edges and avatar stacks | [Images](references/images.md) |
49-
| CJK and mixed scripts, wrapping, figures, visible glyphs and icons | [Typography](references/typography.md) |
50-
| Grouping, hierarchy, disclosure, mixed-content rows and narrow layouts | [Layout](references/layout.md) |
49+
| CJK and mixed scripts, wrapping, figures, baselines, visible glyphs and icons | [Typography](references/typography.md) |
50+
| Grouping, hierarchy, disclosure, mixed-content rows, shared gutters and narrow layouts | [Layout](references/layout.md) |
5151
| Segments, shared seams, concurrent states, targets and focus | [States](references/states.md) |
5252
| State swaps, interruptions and entrance/exit timing | [Motion](references/motion.md) |
5353
| Glass, directional edges, masks and falloff | [Materials](references/materials.md) |

‎.agents/skills/master-design/references/geometry.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,3 +27,13 @@ Test the smallest supported control and the largest relevant container, includin
2727
When a field presents its end action as an evenly inset insert, compare three gaps: block-start, block-end and adjacent inline-end. Measure from the shell's inner boundary to the action's painted boundary, not to its icon ink. With a borderless 40px shell and a 32px action, centered block gaps are 4px; an 8px end gap differs from that intention. A 4px end gap makes this specimen even. Account for physical borders and outward rings separately.
2828

2929
The text's start padding is a different relationship. An attached full-height action, a separator or a deliberate asymmetric composition can have different gaps. Do not force the whole field to four equal paddings or resize the hit target to make the visible inset fit. Check RTL, focus, the smallest supported size and the actual clear/open action.
30+
31+
## Align a control at the end of a bar
32+
33+
Decide what the reader sees at rest before choosing the edge. A control with a visible face or contour is seen by that boundary. A borderless control, such as an icon button that only shows a fill on hover, is seen by its glyph. Align each by what is seen.
34+
35+
In a bar without its own contour, such as a page header flush with the viewport, let a borderless control at either end extend its box into the bar's padding so its glyph meets the edge that the brand, the title and the content below start on. With a 16px icon in a 32px button, the box extends 8px past that edge; only the hover fill shows the difference. A contoured control in the same bar aligns its contour to that edge.
36+
37+
In a holder with its own contour, such as a field, a floating bar, a toast or a banner, keep the embedded end control's box evenly inset from block-start, block-end and inline-end, as described above, so its hover fill stays concentric. When a borderless control in a compact contoured holder leaves its glyph visibly farther from the edge than the content at the opposite end, record the tradeoff: an even box inset or an even glyph inset. Reducing the block gap can satisfy both. Do not move a glyph by changing the hit target.
38+
39+
Determine the end from what is drawn, not from the source order. A popover, a hidden element or a control removed at the current width is not an end. Check RTL, the narrowest width at which the control appears, focus rings near the viewport edge and touch targets, which must not overlap a neighbor after the extension.

‎.agents/skills/master-design/references/layout.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,16 @@ Establish the row's role and density, choose appropriate component sizes, then i
2020

2121
Negative margins can compensate for padding or let an auxiliary element bleed into surrounding whitespace while retaining its border box. With an auto-sized horizontal flex row, a 36px control with -6px block margins can contribute 24px, while its actual target remains 36px high. This is a specimen, not a formula for every layout. Reserve enough unblocked surrounding space, and inspect neighboring targets, focus, hover, clipping and wrapped text. Translation or relative positioning alone moves the visible element but keeps its original layout contribution.
2222

23+
Align a control beside a heading or a multi-line label to the first line, not to the whole block. An action, a status badge or a trailing value centered on a two-line title and description appears to belong to the description. Measure the control's center against the first line's cap-height middle, and give it negative block margins equal to half the difference between its height and the line height so it does not deepen the row. Within one row, choose one strategy: when a checkbox or radio is aligned to the first line, align the trailing value to the first line as well. Avatar rows with short two-line content may center every part instead. Do not mix the two strategies within a row.
24+
2325
Vertical rhythm names the repeated spacing relationship; baseline alignment and optical alignment name different alignment decisions. Bleed describes controlled extension. “Negative-margin compensation” describes the implementation, not a single formal technique covering all these cases. Prefer logical margin/padding properties, and keep adjustments tied to the specific component pairing and density.
2426

27+
## Share one gutter
28+
29+
A page header and the content beneath it share one inline gutter at every width. Where the side navigation is visible, the header can align with the navigation's text instead. When the navigation leaves at a narrower width, the header, the brand and the first column of content should start on the same edge. Change the header's and the content's inline padding together at each breakpoint; a 20px header above 24px content looks like a 4px error, not a deliberate offset.
30+
31+
Test this at the narrowest width with a menu button, a brand, a trailing action and a heading. Measure the menu button's glyph, the brand mark, the heading's first glyph and the trailing action's contour against the same edge. Add safe-area insets to the shared gutter instead of replacing it.
32+
2533
## Table actions and inline contents
2634

2735
Native table row heights accommodate their cells' content and alignment; a declared row height cannot force a larger control to shrink. For a 24px text line with 8px block padding, a 40px row can also hold a 36px control when its action cell has 2px block padding. Keep the control unchanged and adjust the action cell independently. Text may wrap and grow the row; fixed heights and negative margins on table rows/cells do not replace the table sizing model.

‎.agents/skills/master-design/references/typography.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ Preserve the project's typefaces and hierarchy. Wait for the actual font. A comp
66

77
Use balanced wrapping where a short heading benefits from more even lines. Pretty wrapping can improve an isolated last line in prose. Compare fixed content and measure. Algorithms vary by engine and script; do not promise identical breaks or globally balance paragraphs. Test real strings, narrow widths and longer translations.
88

9+
`overflow-wrap: anywhere` and `break-word` both break an unbreakable word that would overflow, but `anywhere` also treats every character as a break opportunity in min-content sizing. A label in a column sized to its content, such as an auto grid track or a flexible stub, can then wrap one letter at a time. Use `break-word` for short labels that may sit in such a column, and keep `anywhere` for long identifiers in fixed-width prose.
10+
911
## Numbers
1012

1113
Use tabular figures for changing values and aligned numeric columns when supported by the font. Confirm widths actually become equal; keep prose figures proportional where appropriate.
@@ -46,6 +48,8 @@ Check body line spacing, short labels and multi-line headings separately. Compar
4648

4749
An inline image, icon, badge, code run, superscript or control can change the line's ascent/descent. `vertical-align` applies to inline-level boxes and table cells; flex/grid items use their alignment model instead. `middle` uses the surrounding font's baseline and x-height, not the containing block's geometric center.
4850

51+
A flex or grid box exports the baseline of its first item that has one. A leading icon, a decorative pseudo-element or a replaced element usually has no text baseline, so a box such as an arrow followed by a percentage can export the icon's bottom edge. In a baseline-aligned row, the percentage then sits above its neighbor's baseline. Align the box's own items on the baseline and center the mark separately. Then measure the visible text baselines in the row; the boxes' alignment alone does not prove the result.
52+
4953
Inspect native control padding, border and line-height before compensating. An inline image's baseline can leave descender space; make it block-level inside a dedicated media slot when it is not part of a sentence. Keep genuine inline content inline and test the actual baseline. Font-relative margins can locally reduce an atomic inline's contribution, but the surrounding line box still sets constraints. Do not promise that subtracting two margins produces exactly the text line height in every engine. Translation and relative offsets move the drawing without removing its original contribution. See [mixed-content rows](layout.md#mixed-content-rows) for layout footprints and available space.
5054

5155
## Compare metrics with the actual words

‎bun.lock‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎bunfig.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ linker = "hoisted"
44
minimumReleaseAge = 86400
55

66
# This exact first-party release was built, tested and verified against its registry tarball.
7-
minimumReleaseAgeExcludes = ["@master/ui@0.0.5", "@master/internal-site@0.2.13","@master/internal-skills@0.1.10","@next/bundle-analyzer@16.3.7", "@next/env@16.3.7", "@next/eslint-plugin-next@16.3.7", "@next/mdx@16.3.7", "@next/swc-darwin-arm64@16.3.7", "@next/swc-darwin-x64@16.3.7", "@next/swc-linux-arm64-gnu@16.3.7", "@next/swc-linux-arm64-musl@16.3.7", "@next/swc-linux-x64-gnu@16.3.7", "@next/swc-linux-x64-musl@16.3.7", "@next/swc-win32-arm64-msvc@16.3.7", "@next/swc-win32-x64-msvc@16.3.7", "@tanstack/history@1.162.2", "@tanstack/react-router@1.170.33", "@tanstack/react-start-client@1.168.31", "@tanstack/react-start-rsc@0.1.49", "@tanstack/react-start-server@1.167.38", "@tanstack/react-start@1.168.50", "@tanstack/router-core@1.171.28", "@tanstack/router-generator@1.167.34", "@tanstack/router-plugin@1.168.36", "@tanstack/start-client-core@1.170.28", "@tanstack/start-plugin-core@1.171.40", "@tanstack/start-server-core@1.169.32", "@tanstack/start-storage-context@1.167.30", "@typescript/typescript-aix-ppc64@7.0.2", "@typescript/typescript-darwin-arm64@7.0.2", "@typescript/typescript-darwin-x64@7.0.2", "@typescript/typescript-freebsd-arm64@7.0.2", "@typescript/typescript-freebsd-x64@7.0.2", "@typescript/typescript-linux-arm64@7.0.2", "@typescript/typescript-linux-arm@7.0.2", "@typescript/typescript-linux-loong64@7.0.2", "@typescript/typescript-linux-mips64el@7.0.2", "@typescript/typescript-linux-ppc64@7.0.2", "@typescript/typescript-linux-riscv64@7.0.2", "@typescript/typescript-linux-s390x@7.0.2", "@typescript/typescript-linux-x64@7.0.2", "@typescript/typescript-netbsd-arm64@7.0.2", "@typescript/typescript-netbsd-x64@7.0.2", "@typescript/typescript-openbsd-arm64@7.0.2", "@typescript/typescript-openbsd-x64@7.0.2", "@typescript/typescript-sunos-x64@7.0.2", "@typescript/typescript-win32-arm64@7.0.2", "@typescript/typescript-win32-x64@7.0.2", "aronrepo", "next@16.3.7", "rolldown-plugin-dts@0.27.4", "typescript@7.0.2"]
7+
minimumReleaseAgeExcludes = ["@master/ui@0.0.5", "@master/internal-site@0.2.13","@master/internal-skills@0.1.11","@next/bundle-analyzer@16.3.7", "@next/env@16.3.7", "@next/eslint-plugin-next@16.3.7", "@next/mdx@16.3.7", "@next/swc-darwin-arm64@16.3.7", "@next/swc-darwin-x64@16.3.7", "@next/swc-linux-arm64-gnu@16.3.7", "@next/swc-linux-arm64-musl@16.3.7", "@next/swc-linux-x64-gnu@16.3.7", "@next/swc-linux-x64-musl@16.3.7", "@next/swc-win32-arm64-msvc@16.3.7", "@next/swc-win32-x64-msvc@16.3.7", "@tanstack/history@1.162.2", "@tanstack/react-router@1.170.33", "@tanstack/react-start-client@1.168.31", "@tanstack/react-start-rsc@0.1.49", "@tanstack/react-start-server@1.167.38", "@tanstack/react-start@1.168.50", "@tanstack/router-core@1.171.28", "@tanstack/router-generator@1.167.34", "@tanstack/router-plugin@1.168.36", "@tanstack/start-client-core@1.170.28", "@tanstack/start-plugin-core@1.171.40", "@tanstack/start-server-core@1.169.32", "@tanstack/start-storage-context@1.167.30", "@typescript/typescript-aix-ppc64@7.0.2", "@typescript/typescript-darwin-arm64@7.0.2", "@typescript/typescript-darwin-x64@7.0.2", "@typescript/typescript-freebsd-arm64@7.0.2", "@typescript/typescript-freebsd-x64@7.0.2", "@typescript/typescript-linux-arm64@7.0.2", "@typescript/typescript-linux-arm@7.0.2", "@typescript/typescript-linux-loong64@7.0.2", "@typescript/typescript-linux-mips64el@7.0.2", "@typescript/typescript-linux-ppc64@7.0.2", "@typescript/typescript-linux-riscv64@7.0.2", "@typescript/typescript-linux-s390x@7.0.2", "@typescript/typescript-linux-x64@7.0.2", "@typescript/typescript-netbsd-arm64@7.0.2", "@typescript/typescript-netbsd-x64@7.0.2", "@typescript/typescript-openbsd-arm64@7.0.2", "@typescript/typescript-openbsd-x64@7.0.2", "@typescript/typescript-sunos-x64@7.0.2", "@typescript/typescript-win32-arm64@7.0.2", "@typescript/typescript-win32-x64@7.0.2", "aronrepo", "next@16.3.7", "rolldown-plugin-dts@0.27.4", "typescript@7.0.2"]
88

99
[run]
1010
# Explicit Bun commands leave real Node available to release and compatibility jobs.

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@
112112
"typescript-eslint": "^8.72.0",
113113
"vite": "^8.3.5",
114114
"vitest": "^5.0.5",
115-
"@master/internal-skills": "0.1.10"
115+
"@master/internal-skills": "0.1.11"
116116
},
117117
"workspaces": [
118118
"packages/*",

0 commit comments

Comments
 (0)