@joewinke/jatui 0.23.0 → 0.24.0

package/dist/utils/clipboard.js

@@ -0,0 +1,59 @@
+/**
+ * Clipboard write that works outside secure contexts.
+ *
+ * `navigator.clipboard` only exists on HTTPS or localhost origins. Apps using
+ * this library are routinely viewed over plain HTTP from another machine
+ * (Tailscale/LAN), where the API is undefined and a bare
+ * `navigator.clipboard.writeText()` throws synchronously — the classic
+ * "copy button silently does nothing" bug.
+ *
+ * Falls back to the legacy hidden-textarea + `document.execCommand('copy')`
+ * path, which still works in every browser the library targets.
+ *
+ * @returns true if the text was (as far as detectable) copied
+ */
+export async function copyText(text) {
+    if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+        try {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        catch {
+            // Permission denied or transient failure — try the legacy path
+        }
+    }
+    try {
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.setAttribute('readonly', '');
+        ta.style.position = 'fixed';
+        ta.style.left = '-9999px';
+        document.body.appendChild(ta);
+        ta.select();
+        const ok = document.execCommand('copy');
+        document.body.removeChild(ta);
+        return ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clipboard read for menu-triggered paste actions (e.g. a context menu "Paste"
+ * item), where there's no native ClipboardEvent to pull text/plain from.
+ *
+ * Requires navigator.clipboard.readText, which needs a secure context and a
+ * user-gesture-driven call (satisfied by a click handler). Returns null on
+ * any failure — missing API, denied permission, non-secure origin — so
+ * callers can fall back to telling the user to press Ctrl+V instead.
+ */
+export async function readClipboardText() {
+    if (typeof navigator === 'undefined' || !navigator.clipboard?.readText)
+        return null;
+    try {
+        return await navigator.clipboard.readText();
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utils/dateFormatters.d.ts

@@ -68,6 +68,10 @@ export declare function taskAge(dateStr: string): {
     color: string;
 };
 export type PacingLevel = 'fresh' | 'aging' | 'stale';
+export interface PacingOptions {
+    /** Return DaisyUI CSS-var tokens (`var(--color-success|warning|error)`) instead of fixed oklch literals, so colors follow the active theme. */
+    themeVars?: boolean;
+}
 export interface PacingResult {
     level: PacingLevel;
     color: string;
@@ -84,6 +88,11 @@ export interface PacingResult {
  *
  * Usage:
  *   const pacing = pacingColor(elapsedSeconds, 30, 120)
- *   // <span style="color: {pacing.color}">{elapsedSeconds}s</span>
+ *   // <span style="color: {pacing.color}">{formatPacingDuration(elapsedSeconds)}</span>
+ *
+ * Pass { themeVars: true } to get DaisyUI CSS-var tokens (var(--color-success|warning|error))
+ * instead of fixed oklch literals — colors then follow the active DaisyUI theme.
  */
-export declare function pacingColor(elapsedSeconds: number, warnAtSeconds: number, alertAtSeconds: number): PacingResult;
+export declare function pacingColor(elapsedSeconds: number, warnAtSeconds: number, alertAtSeconds: number, options?: PacingOptions): PacingResult;
+/** Compact duration format for pacing readouts: "45s", "3m 12s", "1h 05m". */
+export declare function formatPacingDuration(seconds: number): string;

package/dist/utils/dateFormatters.js

@@ -209,12 +209,32 @@ export function taskAge(dateStr) {
  *
  * Usage:
  *   const pacing = pacingColor(elapsedSeconds, 30, 120)
- *   // <span style="color: {pacing.color}">{elapsedSeconds}s</span>
+ *   // <span style="color: {pacing.color}">{formatPacingDuration(elapsedSeconds)}</span>
+ *
+ * Pass { themeVars: true } to get DaisyUI CSS-var tokens (var(--color-success|warning|error))
+ * instead of fixed oklch literals — colors then follow the active DaisyUI theme.
  */
-export function pacingColor(elapsedSeconds, warnAtSeconds, alertAtSeconds) {
+export function pacingColor(elapsedSeconds, warnAtSeconds, alertAtSeconds, options) {
+    if (options?.themeVars) {
+        if (elapsedSeconds >= alertAtSeconds)
+            return { level: 'stale', color: 'var(--color-error)' };
+        if (elapsedSeconds >= warnAtSeconds)
+            return { level: 'aging', color: 'var(--color-warning)' };
+        return { level: 'fresh', color: 'var(--color-success)' };
+    }
     if (elapsedSeconds >= alertAtSeconds)
         return { level: 'stale', color: 'oklch(0.65 0.20 25)' }; // red
     if (elapsedSeconds >= warnAtSeconds)
         return { level: 'aging', color: 'oklch(0.75 0.15 85)' }; // amber
     return { level: 'fresh', color: 'oklch(0.75 0.18 145)' }; // green
 }
+/** Compact duration format for pacing readouts: "45s", "3m 12s", "1h 05m". */
+export function formatPacingDuration(seconds) {
+    const s = Math.max(0, Math.floor(seconds));
+    if (s < 60)
+        return `${s}s`;
+    if (s < 3600)
+        return `${Math.floor(s / 60)}m ${s % 60}s`;
+    const mins = (s % 3600) / 60;
+    return `${Math.floor(s / 3600)}h ${mins < 10 ? '0' : ''}${Math.floor(mins)}m`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",