@zedtech/zedkit-ui 0.1.1 → 0.2.0

package/src/status-dot.tsx

@@ -0,0 +1,42 @@
+import { cn } from "./utils.js";
+
+export type StatusDotTone = "active" | "idle" | "success" | "warning" | "danger";
+
+export interface StatusDotProps {
+  tone?: StatusDotTone;
+  /** Override the default ping (ongoing tones ping, others stay static). */
+  pulse?: boolean;
+  className?: string;
+}
+
+const TONE_COLOR: Record<StatusDotTone, string> = {
+  active: "bg-primary",
+  idle: "bg-muted-foreground/40",
+  success: "bg-success",
+  warning: "bg-warning",
+  danger: "bg-destructive",
+};
+
+const PING_TONES: ReadonlySet<StatusDotTone> = new Set(["active", "warning", "danger"]);
+
+/**
+ * Decorative status dot: pings for ongoing tones (motion-safe), static
+ * otherwise. Pair with visible text (e.g. StatusLabel) — never alone.
+ */
+export function StatusDot({ tone = "active", pulse, className }: StatusDotProps) {
+  const color = TONE_COLOR[tone];
+  const ping = pulse ?? PING_TONES.has(tone);
+  return (
+    <span aria-hidden className={cn("relative flex size-2", className)}>
+      {ping ? (
+        <span
+          className={cn(
+            "absolute inline-flex h-full w-full rounded-full opacity-60 motion-safe:animate-ping",
+            color,
+          )}
+        />
+      ) : null}
+      <span className={cn("relative inline-flex size-2 rounded-full", color)} />
+    </span>
+  );
+}

package/src/styles.css

@@ -1,3 +1,4 @@
+/* Derived from shadcn/ui (theme) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it. */
 @import "tailwindcss";
 
 /*
@@ -115,3 +116,17 @@
       ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
   }
 }
+
+/*
+ * Kit-authored motion (not shadcn): one draw-on keyframe for the
+ * Checkmark state icon. The path carries the animation only under
+ * `motion-safe:`, so reduced motion shows the static full check.
+ */
+@keyframes zk-check-draw {
+  from {
+    stroke-dashoffset: 8;
+  }
+  to {
+    stroke-dashoffset: 0;
+  }
+}

package/src/switch.tsx

@@ -1,3 +1,4 @@
+// Derived from shadcn/ui (switch) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it.
 "use client";
 
 import * as React from "react";

package/src/table.tsx

@@ -1,3 +1,4 @@
+// Derived from shadcn/ui (table) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it.
 import * as React from "react";
 
 import { cn } from "./utils.js";

package/src/tabs.tsx

@@ -1,3 +1,4 @@
+// Derived from shadcn/ui (tabs) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it.
 "use client";
 
 import * as React from "react";

package/src/textarea.tsx

@@ -1,3 +1,4 @@
+// Derived from shadcn/ui (textarea) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it.
 import * as React from "react";
 
 import { cn } from "./utils.js";

package/src/utils.ts

@@ -1,3 +1,4 @@
+// Derived from shadcn/ui (utils (cn)) — see Provenance in packages/ui/README.md. Tolerated exception: migrated to custom code only when customization needs it.
 import { clsx, type ClassValue } from "clsx";
 import { twMerge } from "tailwind-merge";