@livenetworks/ashlar 1.4.1 → 1.6.0

package/scss/config/mixins/_editor.scss

@@ -0,0 +1,124 @@
+@use 'spacing' as *;
+@use 'display' as *;
+@use 'typography' as *;
+@use 'colors' as *;
+@use 'borders' as *;
+@use 'transitions' as *;
+@use 'motion' as *;
+@use 'focus' as *;
+@use 'prose' as *;
+
+// ─── Editor ────────────────────────────────────────────────────
+// Lightweight WYSIWYG editor wrapper: toolbar + contentEditable
+// surface. The editing surface reuses @include prose for content
+// formatting so authored content matches rendered output.
+//
+// Structure:
+//   [data-ln-editor]
+//     > [role="toolbar"]       toolbar (authored container)
+//       > ul > li > button     formatting actions (grouped)
+//     > .ln-editor__surface    contentEditable div (JS-created)
+//     > textarea               hidden source (form submission)
+
+@mixin editor {
+	@include border;
+	border-radius: var(--radius);
+	overflow: hidden;
+	--color-bg: var(--bg-base);
+	background: var(--color-bg);
+
+	// ─── Toolbar ───────────────────────────────────────────────
+	> [role="toolbar"] {
+		@include flex;
+		@include flex-wrap;
+		@include items-center;
+		--gap: var(--size-2xs);
+		gap: var(--gap);
+		--padding-y: var(--size-xs);
+		--padding-x: var(--size-sm);
+		padding: var(--padding-y) var(--padding-x);
+		--color-bg: var(--bg-sunken);
+		background: var(--color-bg);
+		border-bottom: var(--border-width) solid var(--color-border);
+
+		// Button groups — each <ul> is a visual group
+		> ul {
+			@include flex;
+			@include items-center;
+			--gap: var(--size-2xs);
+			gap: var(--gap);
+			list-style: none;
+			padding: 0;
+			margin: 0;
+
+			// Visual separator between groups (not on last)
+			&:not(:last-child) {
+				--padding-x: var(--size-xs);
+				padding-right: var(--padding-x);
+				border-right: var(--border-width) solid var(--color-border);
+				--margin-inline: var(--size-xs);
+				margin-right: var(--margin-inline);
+			}
+		}
+
+		// Toolbar buttons — compact, neutral
+		button {
+			--padding-y: var(--size-2xs);
+			--padding-x: var(--size-xs);
+			padding: var(--padding-y) var(--padding-x);
+			border-radius: var(--radius-sm);
+			background: transparent;
+			color: var(--color-fg);
+			@include transition-colors;
+
+			&:hover {
+				--color-bg: var(--bg-base);
+				background: var(--color-bg);
+			}
+
+			// Active formatting state (JS toggles this class)
+			&.ln-editor-active {
+				--color-bg: var(--bg-base);
+				background: var(--color-bg);
+				color: var(--color-accent);
+			}
+		}
+	}
+
+	// ─── Editing Surface ───────────────────────────────────────
+	> .ln-editor__surface {
+		@include prose;
+		max-width: none; // Override prose's max-width constraint
+		--padding-y: var(--size-md);
+		--padding-x: var(--size-md);
+		padding: var(--padding-y) var(--padding-x);
+		min-height: 8rem;
+		outline: none;
+		cursor: text;
+
+		// Counter the global reset (`ul li, ol li { list-style: none }`).
+		// The reset kills markers on <li> directly; prose only sets
+		// list-style on the <ul>/<ol> container. Restore inheritance
+		// so the container's disc/decimal flows through to each item.
+		ul li { list-style: disc; }
+		ol li { list-style: decimal; }
+
+		// Empty placeholder via CSS
+		&:empty::before {
+			content: attr(data-placeholder);
+			--color-fg: var(--fg-subtle);
+			color: var(--color-fg);
+			pointer-events: none;
+		}
+	}
+
+	// Focus state on the whole editor when editing
+	&:focus-within {
+		border-color: var(--color-accent);
+	}
+
+	// ─── Hidden textarea (source for form submission) ──────────
+	> textarea[data-ln-editor-source] {
+		display: none;
+	}
+}

package/scss/config/mixins/_empty-state.scss

@@ -28,3 +28,10 @@
 		margin-top: var(--margin-block);
 	}
 }
+
+@mixin empty-state-span {
+	grid-column: 1 / -1;
+	width: 100%;
+	height: auto !important;
+	min-height: auto !important;
+}

package/scss/config/mixins/_filter.scss

@@ -0,0 +1,47 @@
+@use 'spacing' as *;
+@use 'display' as *;
+@use 'interaction' as *;
+@use 'transitions' as *;
+@use 'form' as *;
+
+// ─── Filter dropdown — content chrome only ─────────────────────────
+// The floating shell (chrome, fixed positioning, min-width, show/hide)
+// comes from `@mixin popover` on the popover-driven path, OR from
+// `@mixin floating-panel` + scroll box on the ln-data-table dynamic
+// path (see components/_filter.scss). This mixin styles ONLY the inner
+// content: scrollable options box, search input, and the options list
+// (pills via check-list).
+//
+// NOTE: there is intentionally NO clear-button block. The redundant
+// "Clear Filter" button was removed library-wide — the `data-ln-filter-reset`
+// "All" sentinel checkbox already performs the reset. Do not re-introduce a
+// `[data-ln-filter-clear]` selector here.
+//
+// Tunables (consumer-overridable via --var with sane defaults):
+//   --filter-dropdown-max-height  (default 20rem)
+//   --filter-dropdown-overflow-y  (default auto)
+//   --filter-dropdown-item-pad-y  (default var(--size-3xs))
+//
+// Usage:
+//   .column-filter-dropdown { @include filter-dropdown; }
+
+@mixin filter-dropdown {
+	max-height: var(--filter-dropdown-max-height, 20rem);
+	overflow-y: var(--filter-dropdown-overflow-y, auto);
+	text-transform: none; // reset inherited header uppercase
+
+	[data-ln-filter-search] {
+		@include form-input;
+		font-size: var(--filter-dropdown-text, var(--text-xs));
+		--padding-y: var(--size-2xs);
+		--padding-x: var(--size-sm);
+		width: 100%;
+		margin-bottom: var(--size-xs);
+	}
+
+	[data-ln-filter-options] {
+		@include check-list-nav;
+
+		li { padding: var(--filter-dropdown-item-pad-y, var(--size-3xs)) 0; }
+	}
+}

package/scss/config/mixins/_footer.scss

@@ -25,8 +25,7 @@
 	padding: var(--padding-y) var(--padding-x);
 	border-block-start: var(--border-block-start, var(--border-width) solid var(--color-border));
 	background: var(--color-bg);
-	font-size: var(--text-body-sm);
-	line-height: var(--lh-body-sm);
+	@include typography(body-sm);
 	color: var(--color-fg);
 	@include flex;
 	@include items-center;

package/scss/config/mixins/_form.scss

@@ -17,9 +17,8 @@
 
 @mixin form-label {
 	@include block;
-	font-size: var(--text-label-md);
-	line-height: var(--lh-label-md);
-	@include font-medium;
+	@include typography(label-sm);
+	@include font-semibold;
 	color: var(--color-fg);
 	// Structural label-to-input gap (not shell rhythm).
 	--margin-block: var(--size-xs);
@@ -91,12 +90,13 @@
 
 @mixin form-input {
 	@include w-full;
-	--padding-y: var(--size-sm);
+	--padding-y: var(--input-padding-y, var(--size-sm));
 	--padding-x: var(--size-md);
 	padding: var(--padding-y) var(--padding-x);
 	font-size: var(--font-size);
 	line-height: var(--line-height);
 	color: var(--color-fg);
+	--color-bg: var(--input-bg, var(--bg-recessed));
 	background: var(--color-bg);
 	@include border;
 	border-radius: var(--radius);
@@ -211,6 +211,7 @@
 		padding: var(--size-xs) var(--size-sm);   // icon provides its own row spacing
 		--color-fg: var(--fg-subtle);
 		color: var(--color-fg);
+		box-sizing: content-box;
 	}
 
 	> input,
@@ -262,27 +263,93 @@
 @mixin form-input-icon-group {
 	@include form-field-group;
 
-	> input {
-		// Hide the clear button while the field is empty.
-		&:placeholder-shown ~ [data-ln-search-clear] {
-			@include hidden;
-		}
+	// Visually hide the clear button while the field is empty (visibility:hidden
+	// preserves layout space so the input width stays stable).
+	// Structural target: the only button in this group is the clear control.
+	> input:placeholder-shown ~ button {
+		@include invisible;
 	}
 
-	> [data-ln-search-clear] {
-		@include flex-shrink-0;
-		--padding-y: var(--size-2xs);
-		--padding-x: var(--size-2xs);
-		padding: var(--padding-y) var(--padding-x);
-		@include cursor-pointer;
-		--color-fg: var(--fg-subtle);
-		color: var(--color-fg);
+	// Clear control — square hit area, circular highlight on hover only.
+	// Overrides the flush date/submit-button styling inherited from
+	// form-field-group > button (equal specificity, emitted later → wins).
+	> button {
+		align-self: center;                    // cancel inherited stretch
+		aspect-ratio: 1;                       // square hit area
+		padding: var(--size-2xs);              // equal padding all sides (cancels L+R size-sm and T+B 0)
+		border-radius: var(--radius-full);     // circular highlight (square in flat theme)
+		background: transparent;               // transparent idle
 		@include transition-colors;
 
-		&:hover {
+		> .ln-icon {
+			--color-fg: var(--fg-subtle);      // idle icon color
 			color: var(--color-fg);
+			@include transition-colors;        // icon recolor must animate (parent transition won't drive child color)
+		}
+
+		&:hover {
+			background: var(--btn-bg-hover);   // circle highlight appears
+			> .ln-icon {
+				--color-fg: var(--fg-default);
+			}
 		}
 	}
+
+	// Fix C — pull the leading icon and the input text closer.
+	// Inherited from form-field-group at equal specificity; emitted later → wins per property.
+
+	// 1. Zero the input's OWN adjacent side padding (the user's explicit minimum).
+	//    Mirror form-field-group's :not() structure so the override lands at equal
+	//    specificity and replaces only the horizontal padding it set.
+	> input,
+	> select {
+		&:not(:first-child) {
+			padding-left: 0;
+		}
+		&:not(:last-child) {
+			padding-right: 0;
+		}
+	}
+
+	// 2. Reduce ONLY the leading icon's INNER (right) padding so the magnifier sits
+	//    close to the text. KEEP the left padding (inherited --size-sm outer breathing
+	//    room) and KEEP vertical padding. Set padding-right ONLY — never the `padding`
+	//    shorthand (it would clobber left + vertical).
+	> .ln-icon {
+		padding-right: var(--size-xs);   // 8px → 4px; left + vertical inherited from form-field-group
+	}
+}
+
+// ─── Search field — compact icon-group variant (delta-only) ───────
+//
+// Opt-in refinements layered on top of the icon-group chrome that the
+// global auto-bind (components/_form.scss: label:has(> .ln-icon):has(>
+// search/text input)) already supplies. PREREQUISITE: the consumer is an
+// icon + search-input <label> so the auto-bind provides the base shell;
+// on a plain label this emits only the tweaks below, no chrome.
+//
+// Usage (project/demo SCSS):
+//   label.search { @include search; }
+
+@mixin search {
+	width: min(100%, 20rem);          // intrinsic capped field width
+	--color-bg: var(--bg-recessed);   // recessed fill so the white clear-hover reads
+	--btn-bg-hover: var(--bg-base);   // clear button highlights white on hover (token rebind, no specificity override)
+
+	// Density-immune: pin to the dense base scale so the field is one size
+	// everywhere, regardless of ambient [data-density]. Mirror the values
+	// in config/_density.scss — keep in sync.
+	--size-xs: 0.125rem;
+	--size-sm: 0.375rem;
+	--font-size: 0.875rem;
+	--line-height: 1.5;
+
+	// Compact field — smaller vertical padding. form-input self-declares
+	// --padding-y on the input, so override it on the input directly.
+	> input { --padding-y: var(--size-xs); }
+
+	// Compact icons via the --icon-size primitive (no ln-icon--sm class in markup).
+	.ln-icon { --icon-size: 1rem; }
 }
 
 // ─── Checkbox & Radio ───────────────────────────────────────────
@@ -349,7 +416,7 @@
 	@include flex;
 	@include items-center;
 	gap: var(--gap);
-	--padding-y: var(--size-sm);
+	--padding-y: var(--input-padding-y, var(--size-sm));
 	--padding-x: var(--size-md);
 	padding: var(--padding-y) var(--padding-x);
 	@include cursor-pointer;
@@ -516,6 +583,71 @@
 	}
 }
 
+// Segmented track control pills
+@mixin pills-segmented {
+	@include inline-flex;
+	@include items-center;
+	list-style: none;
+	padding: 2px;
+	margin: 0;
+	background-color: var(--bg-recessed);
+	border-radius: var(--radius);
+	border: var(--border-width) solid var(--color-border);
+	width: 100%;
+
+	> li {
+		flex: 1 1 0%;
+		margin: 0;
+		padding: 0;
+		display: block;
+	}
+
+	> li > label:has(> input[type="checkbox"]),
+	> li > label:has(> input[type="radio"]) {
+		@include flex;
+		@include items-center;
+		@include justify-center;
+		padding: var(--size-xs) var(--size-md);
+		border-radius: calc(var(--radius) - 2px);
+		@include cursor-pointer;
+		@include text-sm;
+		@include font-medium;
+		color: var(--fg-muted);
+		@include transition;
+		user-select: none;
+		margin: 0;
+		text-align: center;
+		border: none;
+		background: transparent;
+
+		> input {
+			position: absolute;
+			width: 1px;
+			height: 1px;
+			padding: 0;
+			margin: -1px;
+			overflow: hidden;
+			clip: rect(0, 0, 0, 0);
+			border: 0;
+		}
+
+		&:hover {
+			color: var(--color-fg);
+		}
+
+		&:has(> input:checked) {
+			background-color: var(--bg-base);
+			color: var(--color-fg);
+			@include font-semibold;
+			box-shadow: var(--shadow-resting);
+		}
+
+		&:has(> input:focus-visible) {
+			@include focus-ring;
+		}
+	}
+}
+
 @mixin toggle-switch {
 	appearance: none;
 	position: relative;
@@ -616,6 +748,50 @@
 	li label { @include pill; }
 }
 
+// ─── Check list nav — filter list styled with the nav-link vocabulary ──
+// Same checkbox-filter list as check-list, but the selected item uses the
+// sidebar nav-link active treatment (accent-tint wash + accent text +
+// semibold) instead of the solid-accent pill fill. Shared by the filter
+// popover (@mixin popover) and the ln-table column-filter dropdown
+// (@mixin filter-dropdown) so every filter list matches the sidebar nav
+// (nav-links-rounded). Extends check-list to keep the hidden-input filled
+// structure; overrides only color, weight and size. Consumers that need
+// the checkbox kept keyboard-focusable (popover a11y) re-reveal the input
+// themselves after including this.
+@mixin check-list-nav {
+	@include check-list;
+
+	li label {
+		// Smaller — match the nav link (13px).
+		@include typography(body-sm);
+		// Muted idle text, transparent surface (nav idle).
+		--color-fg: var(--fg-muted);
+		color: var(--color-fg);
+		background: transparent;
+		border: none;
+		// Tighter vertical padding — match nav link height (~31px).
+		--padding-y: var(--size-xs-up);
+		padding: var(--padding-y) var(--padding-x);
+
+		// Hover (unchecked) — subtle accent wash (nav hover).
+		&:hover:not(:has(> input:checked)) {
+			background-color: color-mix(in srgb, var(--color-accent) 7%, transparent);
+		}
+
+		// Selected — nav active vocabulary (replaces solid-accent + white).
+		&:has(> input:checked) {
+			background-color: var(--color-accent-tint-strong);
+			color: var(--color-accent);
+			@include font-semibold;
+		}
+
+		// Selected + hover — keep the wash, don't darken (nav has no darken).
+		&:hover:has(> input:checked) {
+			background-color: var(--color-accent-tint-strong);
+		}
+	}
+}
+
 // ─── Validation states ─────────────────────────────────────────
 // Status colors (error/success) stay raw — no logical --color-status
 // token in scope (see parent plan §6.2).
@@ -642,7 +818,17 @@
 	// Structural error-list margin (not shell rhythm).
 	--margin-block: var(--size-xs);
 	margin-top: var(--margin-block);
-	font-size: var(--text-caption);
-	line-height: var(--lh-caption);
+	@include typography(caption);
 	color: hsl(var(--color-error));
+	min-height: 1.25rem; // Reserves space to prevent form layout shifts when errors appear
+	list-style: none;
+	padding: 0;
+	margin-bottom: 0;
+
+	li {
+		margin: 0;
+		&.hidden {
+			display: none;
+		}
+	}
 }

package/scss/config/mixins/_index.scss

@@ -25,11 +25,13 @@
 @forward 'nav';
 @forward 'btn';
 @forward 'form';
+@forward 'filter';
 @forward 'modal';
 @forward 'breadcrumbs';
 @forward 'loader';
 @forward 'tabs';
 @forward 'table';
+@forward 'sort';
 @forward 'avatar';
 @forward 'footer';
 @forward 'sidebar';
@@ -42,6 +44,7 @@
 @forward 'timeline';
 @forward 'stat-card';
 @forward 'prose';
+@forward 'editor';
 @forward 'kbd';
 @forward 'tooltip';
 @forward 'popover';
@@ -53,6 +56,6 @@
 @forward 'toast';
 @forward 'upload';
 @forward 'translations';
-@forward 'data-table';
 @forward 'ln-table';
 @forward 'ajax';
+@forward 'diagnostics';