@hadoku/task-ui-components 0.0.0-stage → 4.20.4

package/dist/scrollbar.css

@@ -0,0 +1,165 @@
+/* Themed scrollbars for @wolffm/task-ui-components.
+ *
+ * Without this, every scroller renders the platform's bar: a grey Windows
+ * gutter on a coffee or cyberpunk surface. `color-scheme` (set per theme in
+ * @wolffm/themes) only gets the bar to the right light/dark mode, not the
+ * theme's colours.
+ *
+ *   import '@wolffm/task-ui-components/scrollbar.css'
+ *   <div className="task-app-container hdk-scroll">…</div>
+ *
+ * `.hdk-scroll` styles the element it is on AND every scroller inside it, so
+ * one class on an app's root covers the whole app — hadoku_site puts it on
+ * <html>, which covers every micro-frontend at once. The thumb is the theme's
+ * primary colour.
+ *
+ * Every selector is wrapped in `:where()`, so all of this has ZERO
+ * specificity: it is a fallback for scrollers nobody styled. Any rule an app
+ * writes for a scroller — `scrollbar-width: none` on a carousel, its own
+ * `::-webkit-scrollbar` thumb — wins, whatever order the sheets load in.
+ * Modifiers sit on the same element:
+ *
+ *   --subtle    neutral thumb instead of the accent
+ *   --thin      narrower bar (WebKit/Chromium only; see Firefox below)
+ *   --rail      visible track, so the scroll extent reads at a glance
+ *   --autohide  thumb appears only while that scroller is hovered or focused
+ *
+ * The colours are declared on EVERY element under the root (`.hdk-scroll *`),
+ * not once on it. A custom property inherits its RESOLVED value, so a thumb
+ * colour set only on the root would carry the root's theme down into a nested
+ * `[data-theme]` scope: a cyberpunk preview inside a coffee app would scroll
+ * with coffee's accent. Declared per element, each scroller resolves the
+ * tokens of the theme it actually sits in. Sizes are theme-independent and
+ * simply inherit.
+ *
+ * Two engines, two mechanisms. Firefox only knows the standard
+ * `scrollbar-color`/`scrollbar-width`, and only ever gets `auto` width —
+ * `--thin` included. Under overlay scrollbars (GTK's default on Linux)
+ * `thin` draws the idle thumb as a ~1px hairline that antialiases
+ * unevenly along its length and only widens on hover; `auto` idles at a solid
+ * 2px and hovers at 6px, and with classic scrollbars it is a 6px thumb, the
+ * same as the WebKit default below. Chromium and Safari support the
+ * `::-webkit-scrollbar` pseudo-elements, which are the only way to get a
+ * rounded, inset thumb — but Chromium 121+ IGNORES them whenever
+ * `scrollbar-color` or `scrollbar-width` is non-auto, and `scrollbar-color`
+ * inherits. So the WebKit branch resets both to `auto`, or a host page that
+ * sets `scrollbar-color` on <html> would silently switch all of this off.
+ *
+ * Everything sits in `@layer hdk-fallbacks`. A rule in a cascade layer loses
+ * to every unlayered rule and to every layer declared after it — whatever
+ * either's specificity — and Tailwind ships its utilities in layers. Unlayered,
+ * even a zero-specificity rule here would beat `bg-primary`. The page must
+ * declare the layer FIRST, before any other, so it ranks lowest:
+ *
+ *   @layer hdk-fallbacks, base, theme, utilities;
+ *
+ * hadoku_site's global.css does that. A sheet that never names it just gets
+ * these rules below its own unlayered ones, which is also correct.
+ */
+
+@layer hdk-fallbacks {
+  :where(.hdk-scroll) {
+    --hdk-scrollbar-size: 10px;
+    --hdk-scrollbar-pad: 2px;
+  }
+
+  :where(.hdk-scroll),
+  :where(.hdk-scroll *) {
+    --hdk-scrollbar-thumb: var(--color-primary);
+    --hdk-scrollbar-thumb-hover: var(--color-primary-dark);
+    --hdk-scrollbar-track: transparent;
+  }
+
+  :where(.hdk-scroll--thin) {
+    --hdk-scrollbar-size: 6px;
+    --hdk-scrollbar-pad: 1px;
+  }
+
+  :where(.hdk-scroll--subtle),
+  :where(.hdk-scroll--subtle *) {
+    --hdk-scrollbar-thumb: var(--color-border);
+    --hdk-scrollbar-thumb-hover: var(--color-text-muted);
+  }
+
+  :where(.hdk-scroll--rail) {
+    --hdk-scrollbar-size: 12px;
+    --hdk-scrollbar-pad: 3px;
+  }
+
+  :where(.hdk-scroll--rail),
+  :where(.hdk-scroll--rail *) {
+    --hdk-scrollbar-track: var(--color-bg-hover);
+  }
+
+  :where(.hdk-scroll--autohide),
+  :where(.hdk-scroll--autohide *) {
+    --hdk-scrollbar-thumb: transparent;
+  }
+
+  /* On the hovered/focused element itself, so only that scroller's thumb shows —
+   * not every scroller inside an autohide root at once. */
+  :where(.hdk-scroll--autohide:hover),
+  :where(.hdk-scroll--autohide:focus-within),
+  :where(.hdk-scroll--autohide :hover),
+  :where(.hdk-scroll--autohide :focus-within) {
+    --hdk-scrollbar-thumb: var(--color-primary);
+  }
+
+  @supports not selector(::-webkit-scrollbar) {
+    :where(.hdk-scroll),
+    :where(.hdk-scroll *) {
+      scrollbar-width: auto;
+      scrollbar-color: var(--hdk-scrollbar-thumb) var(--hdk-scrollbar-track);
+    }
+  }
+
+  @supports selector(::-webkit-scrollbar) {
+    :where(.hdk-scroll),
+    :where(.hdk-scroll *) {
+      scrollbar-width: auto;
+      scrollbar-color: auto;
+    }
+
+    :where(.hdk-scroll)::-webkit-scrollbar,
+    :where(.hdk-scroll *)::-webkit-scrollbar {
+      width: var(--hdk-scrollbar-size);
+      height: var(--hdk-scrollbar-size);
+      background-color: var(--hdk-scrollbar-track);
+    }
+
+    :where(.hdk-scroll)::-webkit-scrollbar-track,
+    :where(.hdk-scroll *)::-webkit-scrollbar-track {
+      background-color: var(--hdk-scrollbar-track);
+      border-radius: 999px;
+    }
+
+    /* The transparent border plus padding-box clip is what insets the thumb
+     * from the track edge — a margin does nothing on a scrollbar part. */
+    :where(.hdk-scroll)::-webkit-scrollbar-thumb,
+    :where(.hdk-scroll *)::-webkit-scrollbar-thumb {
+      background-color: var(--hdk-scrollbar-thumb);
+      background-clip: padding-box;
+      border: var(--hdk-scrollbar-pad) solid transparent;
+      border-radius: 999px;
+      min-height: 32px;
+      min-width: 32px;
+    }
+
+    :where(.hdk-scroll)::-webkit-scrollbar-thumb:hover,
+    :where(.hdk-scroll *)::-webkit-scrollbar-thumb:hover,
+    :where(.hdk-scroll)::-webkit-scrollbar-thumb:active,
+    :where(.hdk-scroll *)::-webkit-scrollbar-thumb:active {
+      background-color: var(--hdk-scrollbar-thumb-hover);
+    }
+
+    :where(.hdk-scroll)::-webkit-scrollbar-corner,
+    :where(.hdk-scroll *)::-webkit-scrollbar-corner {
+      background-color: transparent;
+    }
+
+    :where(.hdk-scroll)::-webkit-scrollbar-button,
+    :where(.hdk-scroll *)::-webkit-scrollbar-button {
+      display: none;
+    }
+  }
+}

package/dist/select.css

@@ -0,0 +1,251 @@
+/* Select / dropdown styles for @wolffm/task-ui-components.
+ *
+ *   import '@wolffm/task-ui-components/select.css'
+ *   import '@wolffm/task-ui-components/scrollbar.css'   (the open list uses it)
+ *
+ * The trigger variants differ only in their resting surface; the open list
+ * is one look everywhere, so a page mixing variants still has one menu.
+ */
+
+.hdk-select {
+  position: relative;
+  display: inline-flex;
+  min-width: 0;
+  vertical-align: middle;
+}
+
+.hdk-select__trigger {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  min-width: 0;
+  font: inherit;
+  color: var(--color-text);
+  text-align: left;
+  background-color: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  border-radius: var(--hdk-radius);
+  cursor: pointer;
+  transition:
+    border-color var(--transition-fast),
+    background-color var(--transition-fast),
+    box-shadow var(--transition-fast);
+}
+
+.hdk-select__trigger:hover:not(:disabled) {
+  border-color: var(--color-text-muted);
+}
+
+.hdk-select__trigger:focus-visible,
+.hdk-select--open .hdk-select__trigger {
+  outline: none;
+  border-color: var(--color-primary);
+  box-shadow: var(--hdk-shadow-focus-sm);
+}
+
+.hdk-select__trigger:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.hdk-select__value {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.hdk-select__value--placeholder {
+  color: var(--color-text-tertiary);
+}
+
+.hdk-select__chevron {
+  flex-shrink: 0;
+  color: var(--color-text-tertiary);
+  transition: transform var(--transition-fast);
+}
+
+.hdk-select--open .hdk-select__chevron {
+  transform: rotate(180deg);
+}
+
+/* ── trigger variants ─────────────────────────────────────────────────── */
+
+.hdk-select--filled .hdk-select__trigger {
+  background-color: var(--color-bg-hover);
+  border-color: transparent;
+}
+
+.hdk-select--filled .hdk-select__trigger:hover:not(:disabled) {
+  border-color: var(--color-border);
+}
+
+.hdk-select--ghost .hdk-select__trigger {
+  background-color: transparent;
+  border-color: transparent;
+}
+
+.hdk-select--ghost .hdk-select__trigger:hover:not(:disabled) {
+  background-color: var(--color-bg-hover);
+  border-color: transparent;
+}
+
+.hdk-select--underline .hdk-select__trigger {
+  background-color: transparent;
+  border-color: transparent;
+  border-bottom-color: var(--color-border);
+  border-radius: 0;
+}
+
+.hdk-select--underline .hdk-select__trigger:focus-visible,
+.hdk-select--underline.hdk-select--open .hdk-select__trigger {
+  border-color: transparent;
+  border-bottom-color: var(--color-primary);
+  box-shadow: 0 1px 0 0 var(--color-primary);
+}
+
+/* ── sizes ────────────────────────────────────────────────────────────── */
+
+.hdk-select--sm .hdk-select__trigger {
+  font-size: var(--hdk-text-xs);
+  padding: 4px 8px;
+  min-height: 28px;
+}
+
+.hdk-select--md .hdk-select__trigger {
+  font-size: var(--hdk-text-sm);
+  padding: 7px 10px;
+  min-height: 34px;
+}
+
+.hdk-select--lg .hdk-select__trigger {
+  font-size: var(--hdk-text-base);
+  padding: 10px 12px;
+  min-height: 42px;
+}
+
+/* ── open list ────────────────────────────────────────────────────────── */
+
+.hdk-select__menu {
+  position: fixed;
+  z-index: 1000;
+  margin: 0;
+  padding: 4px;
+  list-style: none;
+  overflow-y: auto;
+  max-width: min(420px, calc(100vw - 16px));
+  background-color: var(--color-bg-card);
+  color: var(--color-text);
+  border: 1px solid var(--color-border);
+  border-radius: var(--hdk-radius-lg);
+  box-shadow: var(--hdk-shadow-lg);
+}
+
+.hdk-select__menu:focus {
+  outline: none;
+}
+
+.hdk-select--sm .hdk-select__menu {
+  font-size: var(--hdk-text-xs);
+}
+
+.hdk-select--md .hdk-select__menu {
+  font-size: var(--hdk-text-sm);
+}
+
+.hdk-select--lg .hdk-select__menu {
+  font-size: var(--hdk-text-base);
+}
+
+.hdk-select__option {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 7px 10px;
+  border-radius: var(--hdk-radius);
+  cursor: pointer;
+}
+
+.hdk-select__option--active {
+  background-color: var(--color-bg-hover);
+}
+
+.hdk-select__option--selected {
+  background-color: var(--color-primary-bg);
+  color: var(--color-on-primary-bg);
+}
+
+.hdk-select__option--selected.hdk-select__option--active {
+  box-shadow: inset 0 0 0 1px var(--color-primary);
+}
+
+/* An <optgroup> label in a list installSelectMenus builds from a native select. */
+.hdk-select__group {
+  padding: 8px 10px 2px;
+  font-size: 0.85em;
+  font-weight: var(--font-weight-semibold);
+  color: var(--color-text-secondary);
+  cursor: default;
+}
+
+.hdk-select__option[aria-disabled='true'] {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.hdk-select__option-text {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-width: 0;
+}
+
+.hdk-select__option-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.hdk-select__option-desc {
+  font-size: 0.85em;
+  color: var(--color-text-tertiary);
+}
+
+.hdk-select__option--selected .hdk-select__option-desc {
+  color: inherit;
+  opacity: 0.85;
+}
+
+.hdk-select__check {
+  flex-shrink: 0;
+}
+
+/* ── native ───────────────────────────────────────────────────────────── */
+
+/* Doubled class so the room for the chevron beats each size's `padding`
+ * shorthand above, which would otherwise draw the chevron over the text. */
+.hdk-select__trigger.hdk-select__native {
+  appearance: none;
+  padding-right: 32px;
+}
+
+.hdk-select--sm .hdk-select__trigger.hdk-select__native {
+  padding-right: 26px;
+}
+
+.hdk-select__chevron--native {
+  position: absolute;
+  right: 10px;
+  top: 50%;
+  translate: 0 -50%;
+  pointer-events: none;
+}
+
+/* The OS popup takes option colours from the <select>; without these, a dark
+ * theme can render dark-on-dark options in Chromium on Windows. */
+.hdk-select__native option {
+  background-color: var(--color-bg-card);
+  color: var(--color-text);
+}