@grampro/kit 0.0.0-stage → 2.4.1

package/source/components/input/styles.css

@@ -0,0 +1,295 @@
+/*
+ * Input and OtpInput styles.
+ *
+ * Tokens read the shared --gbs-* variables when they are set on an ancestor
+ * (set them on :root to theme every component at once) and fall back to the
+ * same default palette otherwise. Rules are unlayered: they beat a framework
+ * reset on specificity, and lose to anything you pass through `className`.
+ * With Tailwind v4, import this file after the framework and inside its
+ * components layer - see the README.
+ */
+
+.in-root {
+  --in-bg: var(--gbs-bg, var(--dg-bg, light-dark(#ffffff, #0b0b0e)));
+  --in-fg: var(--gbs-fg, var(--dg-fg, light-dark(#18181b, #f4f4f5)));
+  --in-muted: var(--gbs-muted, var(--dg-muted, light-dark(#71717a, #a1a1aa)));
+  --in-border: var(--gbs-border, var(--dg-border, light-dark(#e4e4e7, #27272a)));
+  --in-hover: var(--gbs-hover, var(--dg-hover, light-dark(#f4f4f5, #1f1f23)));
+  --in-input-bg: var(--gbs-input-bg, var(--dg-input-bg, light-dark(#ffffff, #121216)));
+  --in-readonly-bg: var(--gbs-readonly-bg, light-dark(#fafafa, #0e0e12));
+  --in-accent: var(--gbs-accent, var(--dg-accent, light-dark(#2563eb, #60a5fa)));
+  --in-focus: var(--gbs-focus, var(--dg-focus, light-dark(#2563eb, #60a5fa)));
+  --in-danger: var(--gbs-danger, var(--dg-danger, light-dark(#dc2626, #f87171)));
+  --in-radius: var(--gbs-radius, var(--dg-radius, 8px));
+  --in-font-size: var(--gbs-font-size, var(--dg-font-size, 13px));
+  --in-height: 36px;
+  --in-px: 10px;
+  --in-cell: 42px;
+
+  color-scheme: inherit;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  width: 100%;
+  min-width: 0;
+  font-size: var(--in-font-size);
+  line-height: 1.4;
+  color: var(--in-fg);
+}
+
+:where(.dark, [data-theme="dark"]) .in-root {
+  color-scheme: dark;
+}
+:where(.light, [data-theme="light"]) .in-root {
+  color-scheme: light;
+}
+
+:where(.in-root) *,
+:where(.in-root) *::before,
+:where(.in-root) *::after {
+  box-sizing: border-box;
+}
+
+.in-root[data-size="sm"] {
+  --in-height: 30px;
+  --in-font-size: 12px;
+  --in-px: 8px;
+  --in-cell: 34px;
+}
+.in-root[data-size="lg"] {
+  --in-height: 44px;
+  --in-font-size: 14px;
+  --in-px: 12px;
+  --in-cell: 50px;
+}
+
+.in-label {
+  font-weight: 500;
+}
+.in-label[data-required]::after {
+  content: " *";
+  color: var(--in-danger);
+}
+.in-footer {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+}
+.in-description {
+  flex: 1 1 auto;
+  min-width: 0;
+  color: var(--in-muted);
+  font-size: 0.92em;
+}
+.in-count {
+  flex: none;
+  margin-inline-start: auto;
+  color: var(--in-muted);
+  font-size: 0.92em;
+  font-variant-numeric: tabular-nums;
+}
+.in-count[data-over] {
+  color: var(--in-danger);
+}
+.in-error {
+  color: var(--in-danger);
+  font-size: 0.92em;
+}
+
+/* --------------------------------------------------------------- input */
+
+.in-control {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  width: 100%;
+  height: var(--in-height);
+  padding: 0 calc(var(--in-px) - 4px) 0 var(--in-px);
+  border: 1px solid var(--in-border);
+  border-radius: var(--in-radius);
+  background: var(--in-input-bg);
+  cursor: text;
+}
+.in-control:hover:not([data-disabled]) {
+  border-color: color-mix(in oklab, var(--in-border), var(--in-fg) 25%);
+}
+.in-control:focus-within {
+  outline: 2px solid var(--in-focus);
+  outline-offset: -1px;
+}
+.in-control[data-invalid] {
+  border-color: var(--in-danger);
+  outline-color: var(--in-danger);
+}
+.in-control[data-readonly] {
+  background: var(--in-readonly-bg);
+}
+.in-control[data-disabled] {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+
+.in-input {
+  flex: 1 1 auto;
+  width: 100%;
+  min-width: 0;
+  height: 100%;
+  padding: 0;
+  border: 0;
+  outline: 0;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+}
+.in-input::placeholder {
+  color: var(--in-muted);
+}
+.in-input:disabled {
+  cursor: not-allowed;
+}
+/* Keep browser autofill from painting its own background over the field. */
+.in-input:autofill {
+  box-shadow: 0 0 0 100px var(--in-input-bg) inset;
+  -webkit-text-fill-color: var(--in-fg);
+}
+
+.in-adornment {
+  display: inline-flex;
+  flex: none;
+  align-items: center;
+  color: var(--in-muted);
+  white-space: nowrap;
+}
+.in-adornment[data-side="trailing"] {
+  padding-inline-end: 4px;
+}
+
+.in-icon-button {
+  display: inline-grid;
+  flex: none;
+  place-items: center;
+  width: 26px;
+  height: 26px;
+  padding: 0;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--in-muted);
+  cursor: pointer;
+}
+.in-icon-button:hover:not(:disabled) {
+  background: var(--in-hover);
+  color: var(--in-fg);
+}
+.in-icon-button:focus-visible {
+  outline: 2px solid var(--in-focus);
+  outline-offset: 1px;
+}
+
+/* ----------------------------------------------------------------- otp */
+
+.in-otp {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  width: max-content;
+  max-width: 100%;
+}
+/*
+ * The real input covers the cells but draws nothing: the cells show its value,
+ * and it still receives typing, paste, autofill and assistive technology.
+ */
+.in-otp-input {
+  position: absolute;
+  inset: 0;
+  z-index: 1;
+  width: 100%;
+  height: 100%;
+  padding: 0;
+  border: 0;
+  outline: 0;
+  background: transparent;
+  color: transparent;
+  caret-color: transparent;
+  font-size: 16px; /* 16px keeps iOS from zooming in on focus */
+  letter-spacing: 0;
+  cursor: text;
+}
+.in-otp-input::selection {
+  background: transparent;
+}
+.in-otp-input:autofill {
+  box-shadow: none;
+  -webkit-text-fill-color: transparent;
+}
+.in-otp-input:disabled {
+  cursor: not-allowed;
+}
+
+.in-otp-cell {
+  display: grid;
+  flex: none;
+  place-items: center;
+  width: var(--in-cell);
+  height: calc(var(--in-cell) * 1.15);
+  border: 1px solid var(--in-border);
+  border-radius: var(--in-radius);
+  background: var(--in-input-bg);
+  font-size: 1.35em;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+  transition: border-color 120ms ease;
+}
+.in-otp-cell[data-filled] {
+  border-color: color-mix(in oklab, var(--in-border), var(--in-fg) 30%);
+}
+.in-otp-cell[data-active] {
+  outline: 2px solid var(--in-focus);
+  outline-offset: -1px;
+}
+.in-otp[data-invalid] .in-otp-cell {
+  border-color: var(--in-danger);
+}
+.in-otp[data-invalid] .in-otp-cell[data-active] {
+  outline-color: var(--in-danger);
+}
+.in-otp[data-disabled] .in-otp-cell {
+  opacity: 0.55;
+}
+
+.in-otp-caret {
+  width: 1.5px;
+  height: 1.1em;
+  background: currentColor;
+  animation: in-caret 1s steps(2, jump-none) infinite;
+}
+@keyframes in-caret {
+  50% {
+    opacity: 0;
+  }
+}
+
+.in-otp-separator {
+  flex: none;
+  width: 10px;
+  height: 2px;
+  border-radius: 1px;
+  background: var(--in-muted);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .in-otp-caret {
+    animation: none;
+  }
+  .in-otp-cell {
+    transition: none;
+  }
+}
+
+@media (forced-colors: active) {
+  .in-otp-cell[data-active],
+  .in-control:focus-within {
+    outline-color: Highlight;
+  }
+}

package/source/components/menu/README.md

@@ -0,0 +1,68 @@
+# Menu
+
+A menu of commands for React 19, following the WAI-ARIA menu button pattern. No
+runtime dependencies besides React.
+
+```ts
+import {
+  Menu, MenuItem, MenuCheckboxItem, MenuRadioGroup, MenuRadioItem,
+  MenuGroup, MenuSeparator, MenuSub,
+} from "@/components/menu";
+import "@/components/menu/styles.css";
+```
+
+```tsx
+<Menu trigger={<Button variant="outline">Actions</Button>} label="Row actions">
+  <MenuItem icon={<EditIcon />} shortcut="⌘E" onSelect={edit}>Edit</MenuItem>
+  <MenuSub label="Export">
+    <MenuItem onSelect={() => download("csv")}>CSV</MenuItem>
+    <MenuItem onSelect={() => download("pdf")}>PDF</MenuItem>
+  </MenuSub>
+  <MenuSeparator />
+  <MenuCheckboxItem checked={compact} onCheckedChange={setCompact}>Compact rows</MenuCheckboxItem>
+  <MenuSeparator />
+  <MenuItem destructive onSelect={remove}>Delete</MenuItem>
+</Menu>
+```
+
+| Prop | Default | Description |
+| --- | --- | --- |
+| `trigger` | — | A single element, cloned with the ARIA wiring. |
+| `open` / `defaultOpen` / `onOpenChange` | — | Controlled or uncontrolled. Reasons: `escape`, `outside`, `trigger`, `select`, `api`. |
+| `label` | "Menu" | Names the menu for screen readers. |
+| `side` / `align` / `gap` | `bottom` / `start` / `4` | Flips and clamps to stay on screen. |
+| `closeOnSelect` | `true` | Whether choosing an item closes the menu. |
+| `className`, `classNames`, `style`, `localeText` | — | Slots: `root`, `list`, `item`, `icon`, `label`, `shortcut`, `separator`, `group`, `groupLabel`, `indicator`, `submenu`. |
+
+## Items
+
+| Component | Notes |
+| --- | --- |
+| `MenuItem` | `onSelect`, `icon`, `shortcut`, `disabled`, `destructive`. Closes the menu by default. |
+| `MenuCheckboxItem` | `checked` / `onCheckedChange`. Stays open by default, so several can be toggled. |
+| `MenuRadioGroup` + `MenuRadioItem` | `value` / `onValueChange` on the group, `value` on each item. |
+| `MenuGroup` | A titled section; the title is a label, never focused. |
+| `MenuSeparator` | A rule between sections. |
+| `MenuSub` | A nested menu, opened by hover, Enter or the arrow pointing into it. |
+
+`shortcut` only draws the hint — binding the key is yours, because only the page
+knows what else is listening.
+
+## Keyboard
+
+| Key | Does |
+| --- | --- |
+| `ArrowDown` / `ArrowUp` on the trigger | Opens, starting at the first or last item. |
+| `ArrowDown` / `ArrowUp` | Moves through items, wrapping, skipping disabled ones. |
+| `Home` / `End` | First / last item. |
+| Letters | Typeahead. Repeating a letter cycles through items starting with it. |
+| `Enter` / `Space` | Chooses the focused item. |
+| `ArrowRight` / `ArrowLeft` | Opens a submenu / goes back to its parent (mirrored in RTL). |
+| `Escape` | Closes and returns focus to the trigger. |
+| `Tab` | Closes and carries on through the page. |
+
+Disabled items stay focusable so that someone navigating by keyboard can find
+out an action exists but is unavailable; arrow keys skip past them.
+
+The navigation and typeahead rules are framework-free in `core/navigation.ts`
+and unit-tested there. Placement comes from `shared/core/position.ts`.

package/source/components/menu/core/index.ts

@@ -0,0 +1,11 @@
+// Framework-free: roving focus and typeahead, with no DOM involved.
+export {
+  edgeIndex,
+  isTypeaheadKey,
+  nextIndex,
+  typeaheadBuffer,
+  typeaheadIndex,
+  TYPEAHEAD_RESET_MS,
+} from "./navigation";
+export type { NavigableItem } from "./navigation";
+export type * from "./types";

package/source/components/menu/core/navigation.ts

@@ -0,0 +1,84 @@
+/** How long a run of keystrokes counts as one word for typeahead. */
+export const TYPEAHEAD_RESET_MS = 700;
+
+export interface NavigableItem {
+  /** Disabled items are skipped by the keyboard, as WAI-ARIA's menu pattern allows. */
+  disabled?: boolean;
+  /** The visible text, lowercased by the caller or not — matching ignores case. */
+  text?: string;
+}
+
+/**
+ * The next item to focus from `from`, stepping by `step` and skipping disabled
+ * items. Wraps around, which is what a menu does and a listbox does not.
+ *
+ * Returns -1 when every item is disabled, so callers can leave focus alone
+ * rather than moving it somewhere meaningless.
+ */
+export function nextIndex(items: readonly NavigableItem[], from: number, step: number): number {
+  if (items.length === 0) return -1;
+  // Nothing focused yet: Down starts at the top, Up at the bottom.
+  if (from < 0) return edgeIndex(items, step > 0 ? "first" : "last");
+  for (let moved = 1; moved <= items.length; moved += 1) {
+    const index = (from + step * moved + items.length * moved) % items.length;
+    if (!items[index]?.disabled) return index;
+  }
+  return -1;
+}
+
+/** The first or last item that can be focused. */
+export function edgeIndex(items: readonly NavigableItem[], edge: "first" | "last"): number {
+  const order = edge === "first" ? items.keys() : [...items.keys()].reverse();
+  for (const index of order) {
+    if (!items[index]?.disabled) return index;
+  }
+  return -1;
+}
+
+/**
+ * The item a typed string should jump to, searching from just after `from` and
+ * wrapping, so repeating a letter cycles through the items starting with it.
+ *
+ * Returns -1 when nothing matches, leaving focus where it is rather than
+ * jumping somewhere unrelated.
+ */
+export function typeaheadIndex(
+  items: readonly NavigableItem[],
+  query: string,
+  from: number,
+): number {
+  const needle = query.trim().toLowerCase();
+  if (!needle) return -1;
+
+  // A repeated single letter cycles; anything longer is a prefix search from
+  // the current item, so "sa" after "s" refines instead of jumping on.
+  const repeated = needle.length > 1 && [...needle].every((character) => character === needle[0]);
+  const search = repeated ? needle[0] : needle;
+  const start = repeated || needle.length === 1 ? from + 1 : from;
+
+  for (let offset = 0; offset < items.length; offset += 1) {
+    const index = (start + offset + items.length) % items.length;
+    const item = items[index];
+    if (item?.disabled) continue;
+    if ((item?.text ?? "").trim().toLowerCase().startsWith(search)) return index;
+  }
+  return -1;
+}
+
+/**
+ * Collects the buffer for typeahead: keystrokes within `TYPEAHEAD_RESET_MS` of
+ * each other build a word, and a longer pause starts a new one.
+ */
+export function typeaheadBuffer(
+  previous: string,
+  key: string,
+  elapsedMs: number,
+  resetMs: number = TYPEAHEAD_RESET_MS,
+): string {
+  return elapsedMs > resetMs ? key : previous + key;
+}
+
+/** Whether a key should be added to the typeahead buffer rather than handled. */
+export function isTypeaheadKey(key: string, modified: boolean): boolean {
+  return !modified && key.length === 1 && key !== " " && /\S/.test(key);
+}

package/source/components/menu/core/types.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from "react";
+
+export type MenuSide = "top" | "bottom" | "left" | "right";
+export type MenuAlign = "start" | "end";
+
+/** What closed the menu, so callers can tell a choice from a dismissal. */
+export type MenuCloseReason = "escape" | "outside" | "trigger" | "select" | "api";
+
+export type MenuSlot =
+  | "root"
+  | "list"
+  | "item"
+  | "icon"
+  | "label"
+  | "shortcut"
+  | "separator"
+  | "group"
+  | "groupLabel"
+  | "indicator"
+  | "submenu";
+
+export interface MenuLocaleText {
+  /** Fallback name for a menu with no label. */
+  label: string;
+  /** Announced on a submenu trigger. */
+  submenu(label: string): string;
+}
+
+/** A shortcut shown beside an item. Purely a hint: the menu does not bind keys. */
+export interface MenuShortcut {
+  keys: ReactNode;
+}

package/source/components/menu/index.ts

@@ -0,0 +1,19 @@
+export { Menu, MenuSub } from "./react/Menu";
+export type { MenuHandle, MenuProps, MenuSubProps } from "./react/Menu";
+export {
+  MenuCheckboxItem,
+  MenuGroup,
+  MenuItem,
+  MenuRadioGroup,
+  MenuRadioItem,
+  MenuSeparator,
+} from "./react/items";
+export type {
+  MenuCheckboxItemProps,
+  MenuGroupProps,
+  MenuItemProps,
+  MenuRadioGroupProps,
+  MenuRadioItemProps,
+} from "./react/items";
+export { defaultMenuText } from "./react/locale";
+export * from "./core";