@joewinke/jatui 0.1.24 → 0.1.26

package/dist/components/KeyboardShortcutsOverlay.svelte

@@ -0,0 +1,296 @@
+<script lang="ts">
+	/**
+	 * KeyboardShortcutsOverlay — press `?` to toggle a modal listing the
+	 * keyboard shortcuts available on the current page. Press `?` again or
+	 * `Escape` to dismiss. Input/contenteditable fields and Ctrl/Meta/Alt
+	 * combos are ignored so the shortcut never interferes with typing.
+	 *
+	 * Usage:
+	 *
+	 *   <KeyboardShortcutsOverlay shortcuts={[
+	 *     { key: 'j / ↓', description: 'Focus next item' },
+	 *     { key: 'k / ↑', description: 'Focus previous item' },
+	 *     { key: 'Enter', description: 'Open detail' },
+	 *   ]} />
+	 */
+
+	export interface KeyboardShortcut {
+		key: string;
+		description: string;
+	}
+
+	export interface SectionEntry {
+		key: string;
+		description: string;
+		/** Optional oklch color to tint the key badge — used for legend entries */
+		color?: string;
+	}
+
+	export interface ShortcutSection {
+		title: string;
+		shortcuts: SectionEntry[];
+	}
+
+	let {
+		shortcuts = [],
+		sections,
+		title = 'Keyboard Shortcuts',
+		open = $bindable(false)
+	}: {
+		shortcuts?: KeyboardShortcut[];
+		/**
+		 * Optional grouped sections (e.g. mode-specific shortcut tables for
+		 * /inbox: list / detail / compose). When provided, takes
+		 * precedence over the flat `shortcuts` prop.
+		 */
+		sections?: ShortcutSection[];
+		title?: string;
+		open?: boolean;
+	} = $props();
+
+	let isOpen = $state(open);
+
+	$effect(() => {
+		isOpen = open;
+	});
+	$effect(() => {
+		open = isOpen;
+	});
+
+	function isTypingTarget(target: EventTarget | null): boolean {
+		if (!(target instanceof HTMLElement)) return false;
+		const tag = target.tagName;
+		if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') return true;
+		return target.isContentEditable;
+	}
+
+	function onKeydown(e: KeyboardEvent) {
+		if (e.ctrlKey || e.metaKey || e.altKey) return;
+
+		if (e.key === '?') {
+			// `?` is always Shift+/. Don't trigger while typing — would swallow the char.
+			if (isTypingTarget(e.target)) return;
+			e.preventDefault();
+			isOpen = !isOpen;
+			return;
+		}
+
+		if (isOpen && e.key === 'Escape') {
+			e.preventDefault();
+			isOpen = false;
+		}
+	}
+
+	$effect(() => {
+		window.addEventListener('keydown', onKeydown);
+		return () => window.removeEventListener('keydown', onKeydown);
+	});
+</script>
+
+{#if isOpen}
+	<div
+		class="kso-backdrop"
+		role="presentation"
+		onclick={() => (isOpen = false)}
+	>
+		<div
+			class="kso-panel animate-scale-in"
+			role="dialog"
+			aria-modal="true"
+			aria-label={title}
+			onclick={(e) => e.stopPropagation()}
+			onkeydown={(e) => e.stopPropagation()}
+			tabindex="-1"
+		>
+			<div class="kso-header">
+				<h2 class="kso-title">{title}</h2>
+				<button
+					type="button"
+					class="kso-close"
+					onclick={() => (isOpen = false)}
+					aria-label="Close keyboard shortcuts"
+				>
+					×
+				</button>
+			</div>
+			<div class="kso-list">
+				{#if sections && sections.length > 0}
+					{#each sections as section, sIdx (section.title + '::' + sIdx)}
+						<div class="kso-section-title">{section.title}</div>
+						{#each section.shortcuts as { key, description, color }, i (section.title + '::' + key + '::' + i)}
+							<div class="kso-row">
+								<kbd
+									class="kso-key"
+									style={color
+										? `color:${color};border-color:color-mix(in oklch,${color} 50%,oklch(0.35 0.02 250));background:color-mix(in oklch,${color} 12%,oklch(0.25 0.02 250))`
+										: ''}
+								>
+									{key}
+								</kbd>
+								<span class="kso-description">{description}</span>
+							</div>
+						{/each}
+					{/each}
+				{:else}
+					{#each shortcuts as { key, description }, i (key + '::' + i)}
+						<div class="kso-row">
+							<kbd class="kso-key">{key}</kbd>
+							<span class="kso-description">{description}</span>
+						</div>
+					{/each}
+				{/if}
+				<div class="kso-row kso-row-meta">
+					<kbd class="kso-key">?</kbd>
+					<span class="kso-description">Toggle this overlay</span>
+				</div>
+				<div class="kso-row kso-row-meta">
+					<kbd class="kso-key">Esc</kbd>
+					<span class="kso-description">Close overlay</span>
+				</div>
+			</div>
+		</div>
+	</div>
+{/if}
+
+<style>
+	.kso-backdrop {
+		position: fixed;
+		inset: 0;
+		background: oklch(0 0 0 / 0.6);
+		backdrop-filter: blur(2px);
+		z-index: 60;
+		display: flex;
+		align-items: center;
+		justify-content: center;
+		padding: 1.5rem;
+		animation: kso-fade 0.15s ease-out;
+	}
+
+	.kso-panel {
+		background: oklch(0.18 0.02 250);
+		border: 1px solid oklch(0.30 0.03 250);
+		border-radius: 0.75rem;
+		box-shadow: 0 20px 60px oklch(0 0 0 / 0.6);
+		max-width: 34rem;
+		width: 100%;
+		max-height: 80vh;
+		overflow: hidden;
+		display: flex;
+		flex-direction: column;
+	}
+
+	.kso-header {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		padding: 0.9rem 1.25rem;
+		border-bottom: 1px solid oklch(0.25 0.02 250);
+		flex-shrink: 0;
+	}
+
+	.kso-title {
+		font-size: 0.95rem;
+		font-weight: 600;
+		color: oklch(0.92 0.02 250);
+		margin: 0;
+		letter-spacing: 0.01em;
+	}
+
+	.kso-close {
+		background: transparent;
+		border: none;
+		color: oklch(0.65 0.02 250);
+		font-size: 1.5rem;
+		line-height: 1;
+		cursor: pointer;
+		padding: 0.15rem 0.5rem;
+		border-radius: 0.35rem;
+		transition:
+			background 0.12s ease,
+			color 0.12s ease;
+	}
+
+	.kso-close:hover {
+		color: oklch(0.94 0.02 250);
+		background: oklch(0.25 0.02 250);
+	}
+
+	.kso-list {
+		padding: 0.75rem 1.25rem 1.25rem;
+		display: flex;
+		flex-direction: column;
+		gap: 0.3rem;
+		overflow-y: auto;
+	}
+
+	.kso-row {
+		display: flex;
+		align-items: center;
+		gap: 1rem;
+		padding: 0.4rem 0.25rem;
+	}
+
+	.kso-section-title {
+		font-size: 0.7rem;
+		text-transform: uppercase;
+		letter-spacing: 0.08em;
+		color: oklch(0.62 0.05 240);
+		padding: 0.55rem 0.25rem 0.2rem;
+		border-bottom: 1px solid oklch(0.25 0.02 250);
+		margin-top: 0.25rem;
+	}
+
+	.kso-section-title:first-of-type {
+		margin-top: 0;
+		padding-top: 0.1rem;
+	}
+
+	.kso-row-meta {
+		opacity: 0.7;
+		border-top: 1px dashed oklch(0.25 0.02 250);
+		margin-top: 0.25rem;
+		padding-top: 0.5rem;
+	}
+
+	.kso-row-meta:not(:first-of-type) {
+		border-top: none;
+		margin-top: 0;
+	}
+
+	.kso-key {
+		font-family: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+		font-size: 0.78rem;
+		background: oklch(0.25 0.02 250);
+		border: 1px solid oklch(0.35 0.02 250);
+		border-bottom-width: 2px;
+		border-radius: 0.35rem;
+		padding: 0.18rem 0.55rem;
+		min-width: 3.25rem;
+		text-align: center;
+		color: oklch(0.93 0.02 250);
+		flex-shrink: 0;
+		white-space: nowrap;
+	}
+
+	.kso-description {
+		font-size: 0.85rem;
+		color: oklch(0.78 0.02 250);
+		line-height: 1.35;
+	}
+
+	@keyframes kso-fade {
+		from {
+			opacity: 0;
+		}
+		to {
+			opacity: 1;
+		}
+	}
+
+	@media (prefers-reduced-motion: reduce) {
+		.kso-backdrop,
+		.kso-panel {
+			animation: none !important;
+		}
+	}
+</style>

package/dist/components/KeyboardShortcutsOverlay.svelte.d.ts

@@ -0,0 +1,42 @@
+/**
+ * KeyboardShortcutsOverlay — press `?` to toggle a modal listing the
+ * keyboard shortcuts available on the current page. Press `?` again or
+ * `Escape` to dismiss. Input/contenteditable fields and Ctrl/Meta/Alt
+ * combos are ignored so the shortcut never interferes with typing.
+ *
+ * Usage:
+ *
+ *   <KeyboardShortcutsOverlay shortcuts={[
+ *     { key: 'j / ↓', description: 'Focus next item' },
+ *     { key: 'k / ↑', description: 'Focus previous item' },
+ *     { key: 'Enter', description: 'Open detail' },
+ *   ]} />
+ */
+export interface KeyboardShortcut {
+    key: string;
+    description: string;
+}
+export interface SectionEntry {
+    key: string;
+    description: string;
+    /** Optional oklch color to tint the key badge — used for legend entries */
+    color?: string;
+}
+export interface ShortcutSection {
+    title: string;
+    shortcuts: SectionEntry[];
+}
+type $$ComponentProps = {
+    shortcuts?: KeyboardShortcut[];
+    /**
+     * Optional grouped sections (e.g. mode-specific shortcut tables for
+     * /inbox: list / detail / compose). When provided, takes
+     * precedence over the flat `shortcuts` prop.
+     */
+    sections?: ShortcutSection[];
+    title?: string;
+    open?: boolean;
+};
+declare const KeyboardShortcutsOverlay: import("svelte").Component<$$ComponentProps, {}, "open">;
+type KeyboardShortcutsOverlay = ReturnType<typeof KeyboardShortcutsOverlay>;
+export default KeyboardShortcutsOverlay;

package/dist/components/LazyImage.svelte

@@ -0,0 +1,123 @@
+<script lang="ts">
+  import { onMount, onDestroy } from "svelte"
+
+  let {
+    src = "",
+    alt = "",
+    className = "",
+    aspectRatio = null,
+    fit = "cover",
+    preload = false,
+    priority = false,
+    width = null,
+    height = null,
+  } = $props<{
+    src: string
+    alt: string
+    className?: string
+    aspectRatio?: string | null
+    fit?: "cover" | "contain" | "fill"
+    preload?: boolean
+    priority?: boolean
+    width?: number | null
+    height?: number | null
+  }>()
+
+  let loaded = $state(false)
+  let error = $state(false)
+  // svelte-ignore state_referenced_locally
+  let shouldLoad = $state(preload || priority)
+  let containerRef: HTMLDivElement
+
+  function startLoadingImage() {
+    if (loaded || !src) return
+    shouldLoad = true
+  }
+
+  onMount(() => {
+    if (priority || preload) {
+      startLoadingImage()
+      return
+    }
+
+    if (containerRef) {
+      const observer = new IntersectionObserver(
+        (entries) => {
+          for (const entry of entries) {
+            if (entry.isIntersecting) {
+              startLoadingImage()
+              observer.unobserve(entry.target)
+            }
+          }
+        },
+        { root: null, rootMargin: "200px", threshold: 0.01 }
+      )
+      observer.observe(containerRef)
+      return () => observer.disconnect()
+    }
+  })
+
+  $effect(() => {
+    if (src) {
+      loaded = false
+      error = false
+    }
+  })
+</script>
+
+<div
+  bind:this={containerRef}
+  class="relative overflow-hidden {className}"
+  style={aspectRatio ? `aspect-ratio: ${aspectRatio};` : ""}
+  data-src={src}
+>
+  {#if !loaded && shouldLoad}
+    <div class="skeleton absolute inset-0 w-full h-full"></div>
+  {/if}
+
+  {#if shouldLoad}
+    <img
+      {src}
+      {alt}
+      {width}
+      {height}
+      class="w-full h-full object-{fit} transition-opacity duration-300 {loaded ? 'opacity-100' : 'opacity-0'}"
+      onload={(e) => {
+        loaded = true
+        if (!width || !height) {
+          const img = e.target as HTMLImageElement
+          width = img.naturalWidth
+          height = img.naturalHeight
+        }
+      }}
+      onerror={() => (error = true)}
+      loading={priority ? "eager" : "lazy"}
+      decoding="async"
+    />
+  {/if}
+
+  {#if !shouldLoad}
+    <div
+      class="w-full h-full bg-base-200"
+      style={width && height ? `aspect-ratio: ${width / height};` : ""}
+    ></div>
+  {/if}
+
+  {#if error && shouldLoad}
+    <div class="absolute inset-0 flex items-center justify-center bg-base-200">
+      <div class="flex flex-col items-center text-base-content/70">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="mb-2">
+          <rect width="18" height="18" x="3" y="3" rx="2" ry="2"></rect>
+          <circle cx="9" cy="9" r="2"></circle>
+          <path d="m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21"></path>
+        </svg>
+        <span class="text-xs">Failed to load image</span>
+      </div>
+    </div>
+  {/if}
+</div>
+
+<style>
+  img { will-change: opacity; }
+  .skeleton { transform: translateZ(0); will-change: opacity; }
+</style>

package/dist/components/LazyImage.svelte.d.ts

@@ -0,0 +1,14 @@
+type $$ComponentProps = {
+    src: string;
+    alt: string;
+    className?: string;
+    aspectRatio?: string | null;
+    fit?: "cover" | "contain" | "fill";
+    preload?: boolean;
+    priority?: boolean;
+    width?: number | null;
+    height?: number | null;
+};
+declare const LazyImage: import("svelte").Component<$$ComponentProps, {}, "">;
+type LazyImage = ReturnType<typeof LazyImage>;
+export default LazyImage;