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

package/src/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/src/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);
+}

package/src/theme-picker.css

@@ -0,0 +1,219 @@
+/**
+ * ThemePicker Component Styles
+ * Beautiful theme picker with light/dark pill design
+ *
+ * Required CSS Variables (should be defined by @wolffm/themes):
+ * --color-text
+ * --color-primary
+ * --color-primary-hover
+ * --color-primary-bg
+ * --color-bg-card
+ * --color-text-secondary
+ * --hdk-shadow-focus-sm
+ * --hdk-shadow-md
+ * --hdk-shadow-lg
+ * --transition-fast (e.g., 0.15s ease)
+ * --hdk-space-sm (e.g., 8px)
+ * --hdk-space-md (e.g., 12px)
+ * --hdk-space-lg (e.g., 16px)
+ * --hdk-text-lg (e.g., 18px)
+ * --font-weight-semibold (e.g., 600)
+ */
+
+@import './icon-btn.css';
+
+.theme-picker {
+  position: relative;
+}
+
+/* Theme toggle button: styled by the shared .app-header__icon-btn
+ * (icon-btn.css). `.theme-toggle-btn` stays on the element as a hook only —
+ * giving it values again would be the second copy that drifts. */
+
+/* Theme picker overlay - covers entire viewport for click-outside detection */
+.theme-picker__overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 99;
+  background: transparent;
+}
+
+/* Theme picker dropdown - positioned relative to picker button */
+.theme-picker__dropdown {
+  position: absolute;
+  top: 0;
+  left: calc(100% + var(--hdk-space-md));
+  z-index: 100;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: var(--hdk-space-sm);
+}
+
+/* Inner row: pill tower + settings icon side-by-side */
+.theme-picker__main {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--hdk-space-md);
+}
+
+/* Open-left modifier: dropdown opens to the left of the toggle */
+.theme-picker--open-left .theme-picker__dropdown {
+  left: auto;
+  right: calc(100% + var(--hdk-space-md));
+}
+
+.theme-picker--open-left .theme-picker__main {
+  flex-direction: row-reverse;
+}
+
+/* Theme pill tower - has the shadow */
+.theme-picker__pills {
+  display: flex;
+  flex-direction: column;
+  gap: 0; /* No gap - pancake stack */
+  border-radius: 12px;
+  overflow: hidden;
+  box-shadow: var(--hdk-shadow-lg); /* Shadow on pill tower only */
+}
+
+/* Theme pill - contains light and dark buttons */
+.theme-pill {
+  display: flex;
+  gap: 0;
+  background: transparent;
+  border: none;
+  transition: all var(--transition-fast, 0.15s ease);
+}
+
+/* Separator line between pills */
+.theme-pill:not(:last-child) {
+  border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+}
+
+/* Theme pill buttons */
+.theme-pill__btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: calc(var(--hdk-space-lg) * 1.2); /* 20% bigger total (10% + 10%) */
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  transition: all var(--transition-fast, 0.15s ease);
+  position: relative;
+  overflow: visible; /* Allow border to show */
+}
+
+/* The light/dark pills are the mode toggle itself: they must always LOOK light
+   and dark so the control reads correctly whichever theme is active. These
+   literals are deliberate and are the one place theme tokens must not be used. */
+
+/* Light button default style */
+.theme-pill__btn--light {
+  background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%);
+  color: #1e293b;
+  border-right: 1px solid rgba(0, 0, 0, 0.1);
+}
+
+/* Dark button default style - more cyber with darker background and blue tint */
+.theme-pill__btn--dark {
+  background: linear-gradient(135deg, #0f172a 0%, #020617 100%);
+  color: #64748b;
+  border-left: 1px solid rgba(100, 116, 139, 0.1);
+}
+
+/* First pill top-left corner rounding - rounded corner instead of full circle */
+.theme-pill:first-child .theme-pill__btn--light {
+  border-top-left-radius: 12px;
+}
+
+/* First pill top-right corner rounding */
+.theme-pill:first-child .theme-pill__btn--dark {
+  border-top-right-radius: 12px;
+}
+
+/* Last pill bottom-left corner rounding */
+.theme-pill:last-child .theme-pill__btn--light {
+  border-bottom-left-radius: 12px;
+}
+
+/* Last pill bottom-right corner rounding */
+.theme-pill:last-child .theme-pill__btn--dark {
+  border-bottom-right-radius: 12px;
+}
+
+.theme-pill__btn--light:hover {
+  background: linear-gradient(135deg, #ffffff 0%, #f8fafc 100%);
+  color: var(--color-primary);
+}
+
+.theme-pill__btn--dark:hover {
+  background: linear-gradient(135deg, #1e293b 0%, #0f172a 100%);
+  color: #cbd5e1;
+}
+
+/* Active states - with proper border radius that doesn't clip, 10% bigger border */
+.theme-pill__btn--light.active {
+  background: linear-gradient(135deg, #ffffff 0%, #f0f9ff 100%);
+  color: var(--color-primary);
+  box-shadow: inset 0 0 0 2.2px var(--color-primary); /* Uses theme primary color */
+  font-weight: var(--font-weight-semibold, 600);
+}
+
+.theme-pill__btn--dark.active {
+  background: linear-gradient(135deg, #020617 0%, #000000 100%);
+  color: var(--color-primary); /* Use theme primary color */
+  box-shadow: inset 0 0 0 2.2px var(--color-primary); /* Use theme primary color */
+  font-weight: var(--font-weight-semibold, 600);
+  /* Add glow effect for cyber look */
+  filter: brightness(1.1);
+}
+
+/* Icon container - reduced by ~15% (24px -> 20px) */
+.theme-pill__icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 20px;
+  height: 20px;
+}
+
+.theme-pill__icon svg {
+  width: 100%;
+  height: 100%;
+}
+
+/* Settings icon button - circular, separate from pill tower */
+.theme-picker__settings-icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 44px;
+  height: 44px;
+  padding: 0;
+  border: none;
+  background: var(--color-bg-card);
+  color: var(--color-text-secondary);
+  cursor: pointer;
+  transition: all var(--transition-fast, 0.15s ease);
+  border-radius: 50%; /* Circular */
+  box-shadow: var(--hdk-shadow-md);
+  flex-shrink: 0;
+}
+
+.theme-picker__settings-icon:hover {
+  background: var(--color-primary-bg);
+  color: var(--color-on-primary-bg);
+  transform: rotate(45deg);
+  box-shadow: var(--hdk-shadow-lg);
+}
+
+.theme-picker__settings-icon svg {
+  width: 20px;
+  height: 20px;
+}