@loidolt/theme-styles 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loidolt/theme-styles",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Base styles, fonts, accessibility helpers, and utilities for Loidolt applications",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "build": "node -e \"console.log('theme-styles: source CSS is publish-ready')\""
   },
   "dependencies": {
-    "@loidolt/theme-tokens": "^0.5.0"
+    "@loidolt/theme-tokens": "^0.7.0"
   },
   "publishConfig": {
     "access": "public",

package/src/accessibility.css

@@ -20,7 +20,15 @@
     .ldt-dialog__body,
     .ldt-drawer__body,
     .ldt-tabs__list,
-    .ldt-toggle-group
+    .ldt-toggle-group,
+    .ldt-listbox,
+    .ldt-media-grid,
+    .ldt-map,
+    .ldt-map-features__list,
+    .ldt-layer-manager,
+    .ldt-code__pre,
+    .ldt-toc-panel__wide,
+    .ldt-mermaid
   )
   :where(:focus-visible) {
   outline-offset: -2px;
@@ -41,6 +49,20 @@
   border: 0 !important;
 }
 
+/* Hidden until it, or something inside it, takes focus — for a "skip" or "back to top" link
+   that should not occupy the layout for pointer users. */
+.ldt-sr-only-focusable:not(:focus, :focus-within) {
+  position: absolute !important;
+  width: 1px !important;
+  height: 1px !important;
+  padding: 0 !important;
+  margin: -1px !important;
+  overflow: hidden !important;
+  clip: rect(0, 0, 0, 0) !important;
+  white-space: nowrap !important;
+  border: 0 !important;
+}
+
 .ldt-skip-link {
   position: fixed;
   z-index: var(--loidolt-z-skip-link);
@@ -58,6 +80,20 @@
   min-width: 44px;
   min-height: 44px;
 }
+/* Enlarges the hit area without moving anything: a small glyph button in dense UI keeps its
+   visual size, and an invisible 44px square centred on it takes the press. */
+.ldt-touch-target-expand {
+  position: relative;
+}
+.ldt-touch-target-expand::after {
+  content: '';
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  width: max(100%, 44px);
+  height: max(100%, 44px);
+  transform: translate(-50%, -50%);
+}
 
 /* Preserve the compact visual density for mouse/keyboard layouts, but give touch-first devices
    the 44px target size recommended for comfortable coarse-pointer operation. */
@@ -73,17 +109,63 @@
     .ldt-choice,
     .ldt-switch,
     .ldt-number-field__button,
-    .ldt-menu__item
+    .ldt-menu__item,
+    .ldt-listbox__item,
+    .ldt-combobox,
+    .ldt-password-input,
+    .ldt-chip,
+    .ldt-data-table__edit,
+    .ldt-media-controls__button,
+    .ldt-media-controls__speed,
+    .ldt-media-controls__range,
+    .ldt-lightbox__control,
+    .ldt-media-carousel__control,
+    .ldt-map-features__item,
+    .ldt-map .maplibregl-ctrl-group button,
+    .ldt-layer-manager__toggle,
+    .ldt-code__copy,
+    .ldt-toc__link
   ) {
     min-height: 44px;
   }
-  :where(.ldt-icon-button, .ldt-number-field__button) {
+  :where(
+    .ldt-icon-button,
+    .ldt-number-field__button,
+    .ldt-combobox__trigger,
+    .ldt-password-input__toggle,
+    .ldt-chip__remove,
+    .ldt-media-controls__button,
+    .ldt-lightbox__control,
+    .ldt-media-carousel__control,
+    .ldt-map .maplibregl-ctrl-group button
+  ) {
     min-width: 44px;
   }
+  /* A map marker keeps its drawn size — it points at a spot — and takes a 44px touch. */
+  .ldt-map-marker::after {
+    content: '';
+    position: absolute;
+    inset: 50% auto auto 50%;
+    width: 44px;
+    height: 44px;
+    transform: translate(-50%, -50%);
+  }
+  /* The thumb keeps its drawn size; an invisible 44px square around it takes the touch. */
+  .ldt-slider__thumb {
+    position: relative;
+  }
+  .ldt-slider__thumb::after {
+    content: '';
+    position: absolute;
+    inset: 50% auto auto 50%;
+    width: 44px;
+    height: 44px;
+    transform: translate(-50%, -50%);
+  }
   :where(.ldt-icon-button) {
     width: 44px;
   }
-  .ldt-number-field {
+  .ldt-number-field:not(.ldt-number-field--bare) {
     grid-template-columns: 44px minmax(0, 1fr) 44px;
   }
 }

package/src/components/actions.css

@@ -104,6 +104,19 @@
   border-radius: 50%;
   animation: ldt-spin 0.7s linear infinite;
 }
+.ldt-spinner--sm {
+  width: 0.875rem;
+  height: 0.875rem;
+}
+.ldt-spinner--md {
+  width: 1.25rem;
+  height: 1.25rem;
+}
+.ldt-spinner--lg {
+  width: 2rem;
+  height: 2rem;
+  border-width: 3px;
+}
 @keyframes ldt-spin {
   to {
     transform: rotate(360deg);

package/src/components/charts.css

@@ -0,0 +1,39 @@
+/* @loidolt/theme-charts. The chart itself is painted by ECharts from the same tokens (read at
+   runtime through `createTokenColors`); this file styles everything around the canvas. */
+.ldt-chart {
+  display: grid;
+  gap: 0.5rem;
+  min-width: 0;
+  margin: 0;
+}
+/* The label voice, as a stat's label: a chart caption names data, it is not a heading. */
+.ldt-chart__title {
+  color: var(--loidolt-text-muted);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+}
+.ldt-chart__canvas,
+.ldt-chart__state {
+  position: relative;
+  width: 100%;
+  min-width: 0;
+  height: var(--ldt-chart-height, 20rem);
+}
+.ldt-chart__canvas[hidden] {
+  display: none;
+}
+.ldt-chart__state.ldt-empty-state {
+  height: auto;
+  min-height: var(--ldt-chart-height, 20rem);
+  align-content: center;
+}
+.ldt-chart__alert :where(p) {
+  margin: 0 0 0.5rem;
+}
+.ldt-chart__table-toggle {
+  justify-self: start;
+}
+.ldt-chart__table[hidden] {
+  display: none;
+}

package/src/components/data.css

@@ -196,3 +196,114 @@
 .ldt-record-stepper__count {
   white-space: nowrap;
 }
+/* The filters narrowing a list, each removable on its own. Sits under the list's toolbar. */
+.ldt-filter-chips {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--loidolt-space-2);
+}
+.ldt-filter-chips__list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--loidolt-space-2);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+/* DataTable: selection, editable cells, responsive columns, virtual spacers. */
+.ldt-table :where(th, td).ldt-data-table__select {
+  width: 2.75rem;
+  padding-inline-end: 0;
+}
+.ldt-data-table__radio {
+  width: 1rem;
+  height: 1rem;
+  accent-color: var(--loidolt-accent);
+}
+.ldt-table tbody tr[data-selected] {
+  background: var(--loidolt-surface-alt);
+}
+.ldt-table tbody tr[data-selected] td:first-child {
+  box-shadow: inset 3px 0 0 var(--loidolt-accent);
+}
+.ldt-data-table__spacer td {
+  padding: 0;
+  border: 0;
+}
+/* The resting state of an editable cell: reads as the value, reveals itself on hover or focus. */
+.ldt-data-table__edit {
+  min-height: 1.5rem;
+  width: 100%;
+  border: 0;
+  border-bottom: var(--loidolt-border-width) dashed transparent;
+  padding: 0;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  text-align: inherit;
+  cursor: text;
+}
+.ldt-data-table__edit:hover {
+  border-bottom-color: var(--loidolt-border-control);
+}
+.ldt-data-table__edit-input {
+  width: 100%;
+  min-height: 1.5rem;
+  border: 0;
+  border-bottom: var(--loidolt-border-width) solid var(--loidolt-accent);
+  padding: 0;
+  color: inherit;
+  background: var(--loidolt-surface-input);
+  font: inherit;
+  text-align: inherit;
+}
+@media (max-width: 1024px) {
+  .ldt-table :where(th, td)[data-hide-below='expanded'] {
+    display: none;
+  }
+}
+@media (max-width: 760px) {
+  .ldt-table :where(th, td)[data-hide-below='compact'] {
+    display: none;
+  }
+}
+
+/* A faceted-filter trigger carries the number of values chosen. */
+.ldt-facet__count {
+  display: inline-grid;
+  min-width: 1.25rem;
+  place-items: center;
+  margin-inline-start: 0.4rem;
+  padding-inline: 0.3rem;
+  color: var(--loidolt-on-accent);
+  background: var(--loidolt-accent);
+  font-size: var(--loidolt-font-size-xs);
+}
+
+/* The footer under a data table: status line, rows-per-page, page trail. */
+.ldt-data-table-pagination {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--loidolt-space-3);
+}
+.ldt-data-table-pagination__summary {
+  margin: 0;
+  color: var(--loidolt-text-muted);
+  font: var(--loidolt-font-size-sm) var(--loidolt-font-utility);
+  font-variant-numeric: tabular-nums;
+}
+.ldt-data-table-pagination__size {
+  display: flex;
+  align-items: center;
+  gap: var(--loidolt-space-2);
+  color: var(--loidolt-text-muted);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+}
+.ldt-data-table-pagination__size .ldt-select {
+  width: auto;
+}

package/src/components/docs.css

@@ -0,0 +1,298 @@
+/* @loidolt/theme-docs. Rendered markdown takes `.ldt-prose` for its typography; this file adds
+   what markdown documentation needs beyond it — code frames and highlighting, admonitions,
+   footnotes, diagrams, the table of contents, and the page around them. */
+
+/* --- Headings that link to themselves ------------------------------------------------------- */
+.ldt-heading-anchor {
+  color: inherit;
+  text-decoration: none;
+}
+.ldt-heading-anchor:hover {
+  text-decoration: underline;
+  text-decoration-color: var(--loidolt-accent);
+  text-underline-offset: 0.2em;
+}
+
+/* --- Code ------------------------------------------------------------------------------------ */
+/* Shiki's CSS-variables theme reads `--ldt-syntax-*`; mapping them to the syntax tokens makes
+   highlighted code follow the light and dark themes with no second render. */
+.ldt-code {
+  --ldt-syntax-foreground: var(--loidolt-text-inverse);
+  --ldt-syntax-background: var(--loidolt-surface-inverse);
+  --ldt-syntax-token-keyword: var(--loidolt-syntax-keyword);
+  --ldt-syntax-token-string: var(--loidolt-syntax-string);
+  --ldt-syntax-token-string-expression: var(--loidolt-syntax-string);
+  --ldt-syntax-token-comment: var(--loidolt-syntax-comment);
+  --ldt-syntax-token-constant: var(--loidolt-syntax-constant);
+  --ldt-syntax-token-function: var(--loidolt-syntax-function);
+  --ldt-syntax-token-parameter: var(--loidolt-syntax-parameter);
+  --ldt-syntax-token-punctuation: var(--loidolt-syntax-punctuation);
+  --ldt-syntax-token-link: var(--loidolt-syntax-function);
+  margin: 0 0 1.1em;
+  min-width: 0;
+}
+.ldt-code__header {
+  display: flex;
+  gap: 0.75rem;
+  align-items: center;
+  justify-content: space-between;
+  min-height: 2rem;
+  padding: 0 0 0 0.75rem;
+  border: var(--loidolt-border-width) solid var(--loidolt-border);
+  border-bottom: 0;
+  color: var(--loidolt-text-muted);
+  background: var(--loidolt-surface-alt);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-mono);
+}
+.ldt-code__filename {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.ldt-code__copy {
+  flex: none;
+  margin-inline-start: auto;
+  min-height: 2rem;
+  padding: 0 0.75rem;
+  border: 0;
+  border-inline-start: var(--loidolt-border-width) solid var(--loidolt-border);
+  color: var(--loidolt-text);
+  background: none;
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+  cursor: pointer;
+}
+.ldt-code__copy:hover {
+  background: var(--loidolt-surface);
+}
+.ldt-code__pre {
+  margin: 0;
+  padding: 0.9em 1.1em;
+  overflow-x: auto;
+  border: var(--loidolt-border-width) solid var(--loidolt-border);
+  color: var(--ldt-syntax-foreground);
+  background: var(--ldt-syntax-background);
+  font: 0.85em / var(--loidolt-font-line-height-normal) var(--loidolt-font-mono);
+  tab-size: 2;
+}
+.ldt-code__pre code {
+  padding: 0;
+  border: 0;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+}
+
+/* --- Admonitions ----------------------------------------------------------------------------- */
+.ldt-admonition {
+  margin: 0 0 1.1em;
+}
+.ldt-admonition .ldt-alert__title {
+  margin: 0 0 0.25rem;
+}
+.ldt-admonition .ldt-alert__description > :last-child {
+  margin-bottom: 0;
+}
+
+/* --- Footnotes ------------------------------------------------------------------------------- */
+.ldt-footnote-ref a {
+  padding-inline: 0.1em;
+  text-decoration: none;
+}
+.ldt-footnotes {
+  margin-top: 2em;
+  padding-top: 1em;
+  border-top: var(--loidolt-border-width) solid var(--loidolt-border);
+  color: var(--loidolt-text-muted);
+  font-size: 0.9em;
+}
+.ldt-unsafe-link {
+  text-decoration: underline dotted;
+}
+
+/* --- Diagrams -------------------------------------------------------------------------------- */
+.ldt-mermaid {
+  display: grid;
+  gap: 0.5rem;
+  margin: 0 0 1.1em;
+  padding: 1rem;
+  overflow-x: auto;
+  border: var(--loidolt-border-width) solid var(--loidolt-border);
+  background: var(--loidolt-background);
+}
+.ldt-mermaid__diagram[hidden] {
+  display: none;
+}
+.ldt-mermaid__diagram svg {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  margin-inline: auto;
+}
+.ldt-mermaid__caption {
+  color: var(--loidolt-text-muted);
+  font-size: var(--loidolt-font-size-sm);
+}
+.ldt-mermaid__source summary {
+  color: var(--loidolt-text-muted);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+  cursor: pointer;
+}
+.ldt-mermaid__source pre,
+.ldt-mermaid__fallback,
+pre.ldt-mermaid {
+  margin: 0.5rem 0 0;
+  white-space: pre-wrap;
+  font: var(--loidolt-font-size-sm) var(--loidolt-font-mono);
+}
+
+/* --- Table of contents ----------------------------------------------------------------------- */
+.ldt-toc {
+  font: var(--loidolt-font-size-sm) var(--loidolt-font-utility);
+}
+.ldt-toc__title {
+  margin: 0 0 0.5rem;
+  color: var(--loidolt-text-muted);
+  font-size: var(--loidolt-font-size-xs);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+}
+.ldt-toc__list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.ldt-toc__item {
+  padding-inline-start: calc(var(--ldt-toc-level, 0) * 0.85rem);
+}
+.ldt-toc__link {
+  display: flex;
+  align-items: center;
+  min-block-size: 1.5rem;
+  padding: 0.2rem 0 0.2rem 0.65rem;
+  border-inline-start: 2px solid var(--loidolt-border-soft);
+  color: var(--loidolt-text-muted);
+  text-decoration: none;
+}
+.ldt-toc__link:hover {
+  color: var(--loidolt-text);
+}
+.ldt-toc__link[aria-current='location'] {
+  border-inline-start-color: var(--loidolt-accent);
+  color: var(--loidolt-text);
+}
+.ldt-toc-panel__wide {
+  position: sticky;
+  top: var(--ldt-docs-top, calc(var(--loidolt-size-topbar) + 1rem));
+  max-height: calc(100vh - var(--ldt-docs-top, calc(var(--loidolt-size-topbar) + 1rem)) - 1rem);
+  overflow-y: auto;
+}
+.ldt-toc-panel__compact {
+  display: none;
+}
+/* The contents go behind a button where there is no room beside the page for them. */
+@media (max-width: 1023.98px) {
+  .ldt-toc-panel__wide {
+    display: none;
+  }
+  .ldt-toc-panel__compact {
+    display: block;
+  }
+}
+
+/* --- The page -------------------------------------------------------------------------------- */
+.ldt-markdown-page {
+  display: grid;
+  gap: 1.5rem;
+  min-width: 0;
+}
+.ldt-markdown-page__main {
+  min-width: 0;
+}
+@media (min-width: 1024px) {
+  .ldt-markdown-page--toc {
+    grid-template-columns: minmax(0, 1fr) 14rem;
+    gap: 2.5rem;
+    align-items: start;
+  }
+  .ldt-markdown-page--toc .ldt-markdown-page__toc {
+    grid-column: 2;
+    grid-row: 1;
+  }
+  .ldt-markdown-page--toc .ldt-markdown-page__main {
+    grid-column: 1;
+    grid-row: 1;
+  }
+}
+.ldt-markdown-page__pager {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  justify-content: space-between;
+  margin-top: 2.5rem;
+  padding-top: 1.25rem;
+  border-top: var(--loidolt-border-width) solid var(--loidolt-border);
+}
+.ldt-markdown-page__pager a {
+  display: grid;
+  gap: 0.15rem;
+  min-width: min(14rem, 100%);
+  padding: 0.65rem 0.9rem;
+  border: var(--loidolt-border-width) solid var(--loidolt-border);
+  color: var(--loidolt-text);
+  text-decoration: none;
+}
+.ldt-markdown-page__pager a:hover {
+  border-color: var(--loidolt-border-strong);
+}
+.ldt-markdown-page__next {
+  margin-inline-start: auto;
+  text-align: end;
+}
+.ldt-markdown-page__direction {
+  color: var(--loidolt-text-muted);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-utility);
+  text-transform: uppercase;
+}
+
+/* --- Docs index ------------------------------------------------------------------------------ */
+.ldt-docs-hub {
+  display: grid;
+  gap: 2.25rem;
+}
+.ldt-docs-hub__title {
+  margin: 0;
+}
+.ldt-docs-hub__description {
+  margin: 0.35rem 0 0;
+  color: var(--loidolt-text-muted);
+}
+.ldt-docs-hub__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(min(16rem, 100%), 1fr));
+  gap: 1rem;
+  margin: 1rem 0 0;
+  padding: 0;
+  list-style: none;
+}
+.ldt-docs-hub__grid > li {
+  display: grid;
+}
+/* A docs card is often only a heading and a line; drop the empty body and its rule. */
+.ldt-docs-card .ldt-card__content:empty {
+  display: none;
+}
+.ldt-docs-card .ldt-card__header:has(+ .ldt-card__content:empty) {
+  border-bottom: 0;
+}
+.ldt-docs-card__eyebrow {
+  margin: 0 0 0.35rem;
+  color: var(--loidolt-text-accent);
+  font: var(--loidolt-font-size-xs) var(--loidolt-font-utility);
+  letter-spacing: var(--loidolt-font-tracking-wide);
+  text-transform: uppercase;
+}