Skip to content

Add .sf-gap and .sf-equal layout utility classes #117

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jackgranatowski merged 5 commits into from
May 27, 2026
Merged

Add .sf-gap and .sf-equal layout utility classes #117

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
86fb349
feat(layout): add .sf-gap and .sf-equal primitives
claude May 27, 2026
96f6956
chore(docs): regenerate token/class reference for .sf-gap and .sf-equal
claude May 27, 2026
6f3a308
test: update snapshot and demo coverage for .sf-gap and .sf-equal
claude May 27, 2026
6d551ed
chore(dist): rebuild minified bundles
claude May 27, 2026
6e2f02d
refactor(layout): align .sf-gap--* modifiers with .sf-stack/.sf-clust…
claude May 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions core/layout.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,22 @@
.sf-stack--end { align-items: flex-end; }
.sf-stack--stretch { align-items: stretch; }

/* -- Gap ----------------------------------------------------
Injects gap into any existing flex or grid container without
imposing a display type or axis. Unlike .sf-stack (flex
column) or .sf-cluster (flex-wrap row), .sf-gap is layout-
agnostic — use it on elements that already have their own
display context.
Override: style="--sf-gap-size: 2rem"
---------------------------------------------------------- */
.sf-gap { gap: var(--sf-gap-size); }
.sf-gap--xs { gap: var(--sf-space-xs); }
.sf-gap--s { gap: var(--sf-space-s); }
.sf-gap--m { gap: var(--sf-space-m); }
.sf-gap--l { gap: var(--sf-space-l); }
.sf-gap--xl { gap: var(--sf-space-xl); }
.sf-gap--2xl { gap: var(--sf-space-2xl); }

/* -- Box -----------------------------------------------------
Isolated unit with padding and an optional border.
Outline instead of border — doesn't disturb the box model when toggled.
Expand Down Expand Up @@ -446,6 +462,23 @@
.sf-grid-3-1 { grid-template-columns: 3fr 1fr; }
}

/* -- Equal columns ------------------------------------------
Fixed N-column grid. Column count NEVER collapses — unlike
.sf-grid-N which uses container queries to stack at small
sizes. Use when the layout must remain N columns at all
widths; the caller is responsible for overflow handling.
Override: style="--sf-equal-cols: 3"
---------------------------------------------------------- */
.sf-equal {
display: grid;
grid-template-columns: repeat(var(--sf-equal-cols), 1fr);
gap: var(--sf-equal-gap);
}
.sf-equal--2 { --sf-equal-cols: 2; }
.sf-equal--3 { --sf-equal-cols: 3; }
.sf-equal--4 { --sf-equal-cols: 4; }
.sf-equal--6 { --sf-equal-cols: 6; }

/* -- Content grid (breakout pattern) -------------------------
Full-width grid that lets items break out to breakout or full
width. Children default to the content column.
Expand Down
11 changes: 11 additions & 0 deletions core/tokens.layout.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,11 @@
---------------------------------------------------------- */
--sf-stack-gap: var(--sf-space-content);

/* ----------------------------------------------------------
Gap
---------------------------------------------------------- */
--sf-gap-size: var(--sf-space-gap);

/* ----------------------------------------------------------
Box
---------------------------------------------------------- */
Expand Down Expand Up @@ -82,6 +87,12 @@
--sf-grid-min-xl: 24rem;
--sf-grid-min-2xl: 28rem;

/* ----------------------------------------------------------
Equal columns (fixed, non-responsive)
---------------------------------------------------------- */
--sf-equal-cols: 2;
--sf-equal-gap: var(--sf-space-gap);

/* ----------------------------------------------------------
Cover
---------------------------------------------------------- */
Expand Down
44 changes: 44 additions & 0 deletions dist/slashed.essential.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1056,6 +1056,11 @@
---------------------------------------------------------- */
--sf-stack-gap: var(--sf-space-content);

/* ----------------------------------------------------------
Gap
---------------------------------------------------------- */
--sf-gap-size: var(--sf-space-gap);

/* ----------------------------------------------------------
Box
---------------------------------------------------------- */
Expand Down Expand Up @@ -1102,6 +1107,12 @@
--sf-grid-min-xl: 24rem;
--sf-grid-min-2xl: 28rem;

/* ----------------------------------------------------------
Equal columns (fixed, non-responsive)
---------------------------------------------------------- */
--sf-equal-cols: 2;
--sf-equal-gap: var(--sf-space-gap);

/* ----------------------------------------------------------
Cover
---------------------------------------------------------- */
Expand Down Expand Up @@ -1770,6 +1781,22 @@
.sf-stack--end { align-items: flex-end; }
.sf-stack--stretch { align-items: stretch; }

/* -- Gap ----------------------------------------------------
Injects gap into any existing flex or grid container without
imposing a display type or axis. Unlike .sf-stack (flex
column) or .sf-cluster (flex-wrap row), .sf-gap is layout-
agnostic — use it on elements that already have their own
display context.
Override: style="--sf-gap-size: 2rem"
---------------------------------------------------------- */
.sf-gap { gap: var(--sf-gap-size); }
.sf-gap--xs { gap: var(--sf-space-xs); }
.sf-gap--s { gap: var(--sf-space-s); }
.sf-gap--m { gap: var(--sf-space-m); }
.sf-gap--l { gap: var(--sf-space-l); }
.sf-gap--xl { gap: var(--sf-space-xl); }
.sf-gap--2xl { gap: var(--sf-space-2xl); }

/* -- Box -----------------------------------------------------
Isolated unit with padding and an optional border.
Outline instead of border — doesn't disturb the box model when toggled.
Expand Down Expand Up @@ -2113,6 +2140,23 @@
.sf-grid-3-1 { grid-template-columns: 3fr 1fr; }
}

/* -- Equal columns ------------------------------------------
Fixed N-column grid. Column count NEVER collapses — unlike
.sf-grid-N which uses container queries to stack at small
sizes. Use when the layout must remain N columns at all
widths; the caller is responsible for overflow handling.
Override: style="--sf-equal-cols: 3"
---------------------------------------------------------- */
.sf-equal {
display: grid;
grid-template-columns: repeat(var(--sf-equal-cols), 1fr);
gap: var(--sf-equal-gap);
}
.sf-equal--2 { --sf-equal-cols: 2; }
.sf-equal--3 { --sf-equal-cols: 3; }
.sf-equal--4 { --sf-equal-cols: 4; }
.sf-equal--6 { --sf-equal-cols: 6; }

/* -- Content grid (breakout pattern) -------------------------
Full-width grid that lets items break out to breakout or full
width. Children default to the content column.
Expand Down
44 changes: 44 additions & 0 deletions dist/slashed.essential.flat.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1035,6 +1035,11 @@
---------------------------------------------------------- */
--sf-stack-gap: var(--sf-space-content);

/* ----------------------------------------------------------
Gap
---------------------------------------------------------- */
--sf-gap-size: var(--sf-space-gap);

/* ----------------------------------------------------------
Box
---------------------------------------------------------- */
Expand Down Expand Up @@ -1081,6 +1086,12 @@
--sf-grid-min-xl: 24rem;
--sf-grid-min-2xl: 28rem;

/* ----------------------------------------------------------
Equal columns (fixed, non-responsive)
---------------------------------------------------------- */
--sf-equal-cols: 2;
--sf-equal-gap: var(--sf-space-gap);

/* ----------------------------------------------------------
Cover
---------------------------------------------------------- */
Expand Down Expand Up @@ -1736,6 +1747,22 @@ td, th {
.sf-stack--end { align-items: flex-end; }
.sf-stack--stretch { align-items: stretch; }

/* -- Gap ----------------------------------------------------
Injects gap into any existing flex or grid container without
imposing a display type or axis. Unlike .sf-stack (flex
column) or .sf-cluster (flex-wrap row), .sf-gap is layout-
agnostic — use it on elements that already have their own
display context.
Override: style="--sf-gap-size: 2rem"
---------------------------------------------------------- */
.sf-gap { gap: var(--sf-gap-size); }
.sf-gap--xs { gap: var(--sf-space-xs); }
.sf-gap--s { gap: var(--sf-space-s); }
.sf-gap--m { gap: var(--sf-space-m); }
.sf-gap--l { gap: var(--sf-space-l); }
.sf-gap--xl { gap: var(--sf-space-xl); }
.sf-gap--2xl { gap: var(--sf-space-2xl); }

/* -- Box -----------------------------------------------------
Isolated unit with padding and an optional border.
Outline instead of border — doesn't disturb the box model when toggled.
Expand Down Expand Up @@ -2079,6 +2106,23 @@ td, th {
.sf-grid-3-1 { grid-template-columns: 3fr 1fr; }
}

/* -- Equal columns ------------------------------------------
Fixed N-column grid. Column count NEVER collapses — unlike
.sf-grid-N which uses container queries to stack at small
sizes. Use when the layout must remain N columns at all
widths; the caller is responsible for overflow handling.
Override: style="--sf-equal-cols: 3"
---------------------------------------------------------- */
.sf-equal {
display: grid;
grid-template-columns: repeat(var(--sf-equal-cols), 1fr);
gap: var(--sf-equal-gap);
}
.sf-equal--2 { --sf-equal-cols: 2; }
.sf-equal--3 { --sf-equal-cols: 3; }
.sf-equal--4 { --sf-equal-cols: 4; }
.sf-equal--6 { --sf-equal-cols: 6; }

/* -- Content grid (breakout pattern) -------------------------
Full-width grid that lets items break out to breakout or full
width. Children default to the content column.
Expand Down
2 changes: 1 addition & 1 deletion dist/slashed.essential.flat.min.css
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.essential.flat.min.css.map
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.essential.min.css
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.essential.min.css.map
View file
Open in desktop

Large diffs are not rendered by default.

44 changes: 44 additions & 0 deletions dist/slashed.full.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1056,6 +1056,11 @@
---------------------------------------------------------- */
--sf-stack-gap: var(--sf-space-content);

/* ----------------------------------------------------------
Gap
---------------------------------------------------------- */
--sf-gap-size: var(--sf-space-gap);

/* ----------------------------------------------------------
Box
---------------------------------------------------------- */
Expand Down Expand Up @@ -1102,6 +1107,12 @@
--sf-grid-min-xl: 24rem;
--sf-grid-min-2xl: 28rem;

/* ----------------------------------------------------------
Equal columns (fixed, non-responsive)
---------------------------------------------------------- */
--sf-equal-cols: 2;
--sf-equal-gap: var(--sf-space-gap);

/* ----------------------------------------------------------
Cover
---------------------------------------------------------- */
Expand Down Expand Up @@ -1770,6 +1781,22 @@
.sf-stack--end { align-items: flex-end; }
.sf-stack--stretch { align-items: stretch; }

/* -- Gap ----------------------------------------------------
Injects gap into any existing flex or grid container without
imposing a display type or axis. Unlike .sf-stack (flex
column) or .sf-cluster (flex-wrap row), .sf-gap is layout-
agnostic — use it on elements that already have their own
display context.
Override: style="--sf-gap-size: 2rem"
---------------------------------------------------------- */
.sf-gap { gap: var(--sf-gap-size); }
.sf-gap--xs { gap: var(--sf-space-xs); }
.sf-gap--s { gap: var(--sf-space-s); }
.sf-gap--m { gap: var(--sf-space-m); }
.sf-gap--l { gap: var(--sf-space-l); }
.sf-gap--xl { gap: var(--sf-space-xl); }
.sf-gap--2xl { gap: var(--sf-space-2xl); }

/* -- Box -----------------------------------------------------
Isolated unit with padding and an optional border.
Outline instead of border — doesn't disturb the box model when toggled.
Expand Down Expand Up @@ -2113,6 +2140,23 @@
.sf-grid-3-1 { grid-template-columns: 3fr 1fr; }
}

/* -- Equal columns ------------------------------------------
Fixed N-column grid. Column count NEVER collapses — unlike
.sf-grid-N which uses container queries to stack at small
sizes. Use when the layout must remain N columns at all
widths; the caller is responsible for overflow handling.
Override: style="--sf-equal-cols: 3"
---------------------------------------------------------- */
.sf-equal {
display: grid;
grid-template-columns: repeat(var(--sf-equal-cols), 1fr);
gap: var(--sf-equal-gap);
}
.sf-equal--2 { --sf-equal-cols: 2; }
.sf-equal--3 { --sf-equal-cols: 3; }
.sf-equal--4 { --sf-equal-cols: 4; }
.sf-equal--6 { --sf-equal-cols: 6; }

/* -- Content grid (breakout pattern) -------------------------
Full-width grid that lets items break out to breakout or full
width. Children default to the content column.
Expand Down
44 changes: 44 additions & 0 deletions dist/slashed.full.flat.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1035,6 +1035,11 @@
---------------------------------------------------------- */
--sf-stack-gap: var(--sf-space-content);

/* ----------------------------------------------------------
Gap
---------------------------------------------------------- */
--sf-gap-size: var(--sf-space-gap);

/* ----------------------------------------------------------
Box
---------------------------------------------------------- */
Expand Down Expand Up @@ -1081,6 +1086,12 @@
--sf-grid-min-xl: 24rem;
--sf-grid-min-2xl: 28rem;

/* ----------------------------------------------------------
Equal columns (fixed, non-responsive)
---------------------------------------------------------- */
--sf-equal-cols: 2;
--sf-equal-gap: var(--sf-space-gap);

/* ----------------------------------------------------------
Cover
---------------------------------------------------------- */
Expand Down Expand Up @@ -1736,6 +1747,22 @@ td, th {
.sf-stack--end { align-items: flex-end; }
.sf-stack--stretch { align-items: stretch; }

/* -- Gap ----------------------------------------------------
Injects gap into any existing flex or grid container without
imposing a display type or axis. Unlike .sf-stack (flex
column) or .sf-cluster (flex-wrap row), .sf-gap is layout-
agnostic — use it on elements that already have their own
display context.
Override: style="--sf-gap-size: 2rem"
---------------------------------------------------------- */
.sf-gap { gap: var(--sf-gap-size); }
.sf-gap--xs { gap: var(--sf-space-xs); }
.sf-gap--s { gap: var(--sf-space-s); }
.sf-gap--m { gap: var(--sf-space-m); }
.sf-gap--l { gap: var(--sf-space-l); }
.sf-gap--xl { gap: var(--sf-space-xl); }
.sf-gap--2xl { gap: var(--sf-space-2xl); }

/* -- Box -----------------------------------------------------
Isolated unit with padding and an optional border.
Outline instead of border — doesn't disturb the box model when toggled.
Expand Down Expand Up @@ -2079,6 +2106,23 @@ td, th {
.sf-grid-3-1 { grid-template-columns: 3fr 1fr; }
}

/* -- Equal columns ------------------------------------------
Fixed N-column grid. Column count NEVER collapses — unlike
.sf-grid-N which uses container queries to stack at small
sizes. Use when the layout must remain N columns at all
widths; the caller is responsible for overflow handling.
Override: style="--sf-equal-cols: 3"
---------------------------------------------------------- */
.sf-equal {
display: grid;
grid-template-columns: repeat(var(--sf-equal-cols), 1fr);
gap: var(--sf-equal-gap);
}
.sf-equal--2 { --sf-equal-cols: 2; }
.sf-equal--3 { --sf-equal-cols: 3; }
.sf-equal--4 { --sf-equal-cols: 4; }
.sf-equal--6 { --sf-equal-cols: 6; }

/* -- Content grid (breakout pattern) -------------------------
Full-width grid that lets items break out to breakout or full
width. Children default to the content column.
Expand Down
2 changes: 1 addition & 1 deletion dist/slashed.full.flat.min.css
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.full.flat.min.css.map
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.full.min.css
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/slashed.full.min.css.map
View file
Open in desktop

Large diffs are not rendered by default.

Loading