@refraction-ui/react 0.4.2 → 0.6.0

package/README.md

@@ -7,7 +7,15 @@ npm install @refraction-ui/react
 ```
 
 ```tsx
-import { Button, Card, Dialog, ThemeProvider } from '@refraction-ui/react'
+import { Button, Card, Dialog } from '@refraction-ui/react'
+import { ThemeProvider } from '@refraction-ui/react/theme'
+```
+
+React Hook Form-backed primitives are opt-in so the root package does not force
+every consumer to install `react-hook-form`:
+
+```tsx
+import { Form, FormField, useForm } from '@refraction-ui/react/form'
 ```
 
 ## Default theme stylesheet

package/dist/chunk-O4453CBF.js

@@ -0,0 +1,137 @@
+// ../shared/dist/index.js
+var idCounter = 0;
+function generateId(prefix = "rfr") {
+  idCounter++;
+  return `${prefix}-${idCounter}`;
+}
+var Keys = {
+  Enter: "Enter",
+  Space: " ",
+  Escape: "Escape",
+  Tab: "Tab",
+  ArrowUp: "ArrowUp",
+  ArrowDown: "ArrowDown",
+  ArrowLeft: "ArrowLeft",
+  ArrowRight: "ArrowRight",
+  Home: "Home",
+  End: "End",
+  PageUp: "PageUp",
+  PageDown: "PageDown",
+  Backspace: "Backspace",
+  Delete: "Delete"
+};
+function createKeyboardHandler(handlers) {
+  return (event) => {
+    const handler = handlers[event.key];
+    if (handler) {
+      handler(event);
+    }
+  };
+}
+function createMachine(config) {
+  let current = config.initial;
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    get state() {
+      return current;
+    },
+    send(event) {
+      const stateConfig = config.states[current];
+      const next = stateConfig?.on?.[event];
+      if (next && next !== current) {
+        current = next;
+        for (const fn of listeners) {
+          fn(current);
+        }
+      }
+    },
+    subscribe(fn) {
+      listeners.add(fn);
+      return () => {
+        listeners.delete(fn);
+      };
+    },
+    matches(state) {
+      return current === state;
+    }
+  };
+}
+function cn(...inputs) {
+  const classes = [];
+  for (const input of inputs) {
+    if (!input) continue;
+    if (typeof input === "string") {
+      classes.push(input);
+    } else if (typeof input === "number") {
+      classes.push(String(input));
+    } else if (Array.isArray(input)) {
+      const nested = cn(...input);
+      if (nested) classes.push(nested);
+    } else if (typeof input === "object") {
+      for (const [key, value] of Object.entries(input)) {
+        if (value) classes.push(key);
+      }
+    }
+  }
+  return classes.join(" ");
+}
+function cva(config) {
+  return (props) => {
+    const classes = [];
+    if (config.base) {
+      classes.push(config.base);
+    }
+    if (config.variants) {
+      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {
+        const selectedValue = props?.[variantKey] ?? config.defaultVariants?.[variantKey];
+        if (selectedValue != null) {
+          const variantClass = variantOptions[selectedValue];
+          if (variantClass) {
+            classes.push(variantClass);
+          }
+        }
+      }
+    }
+    if (config.compoundVariants) {
+      for (const compound of config.compoundVariants) {
+        const { class: compoundClass, ...conditions } = compound;
+        let matches = true;
+        for (const [key, value] of Object.entries(conditions)) {
+          const propValue = props?.[key] ?? config.defaultVariants?.[key];
+          if (propValue !== value) {
+            matches = false;
+            break;
+          }
+        }
+        if (matches) {
+          classes.push(compoundClass);
+        }
+      }
+    }
+    if (props?.className) {
+      classes.push(props.className);
+    }
+    return classes.filter(Boolean).join(" ");
+  };
+}
+var seen = /* @__PURE__ */ new Set();
+function isDev() {
+  return typeof process === "undefined" || process.env?.NODE_ENV !== "production";
+}
+function emit(level, code, message, detail) {
+  if (!isDev()) return;
+  const key = `${level}:${code}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  const text = `[refraction-ui] ${code}: ${message}`;
+  {
+    console.warn(text, detail ?? "");
+  }
+}
+function devWarn(code, message, detail) {
+  emit("warn", code, message, detail);
+}
+
+export { Keys, cn, createKeyboardHandler, createMachine, cva, devWarn, generateId };
+//# sourceMappingURL=chunk-O4453CBF.js.map
+//# sourceMappingURL=chunk-O4453CBF.js.map

package/dist/chunk-O4453CBF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../shared/src/aria.ts","../../shared/src/keyboard.ts","../../shared/src/state-machine.ts","../../shared/src/cn.ts","../../shared/src/cva.ts","../../shared/src/dev-feedback.ts"],"names":[],"mappings":"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","file":"chunk-O4453CBF.js","sourcesContent":["/** Merge multiple ARIA prop objects, later values override earlier ones */\nexport function mergeAriaProps(\n  ...propSets: Array<Record<string, unknown>>\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {}\n  for (const props of propSets) {\n    for (const [key, value] of Object.entries(props)) {\n      if (value !== undefined) {\n        result[key] = value\n      }\n    }\n  }\n  return result\n}\n\nlet idCounter = 0\n\n/**\n * Generate a unique ID, safe for SSR (deterministic within a render pass).\n * In browsers, uses crypto.randomUUID when available.\n */\nexport function generateId(prefix = 'rfr'): string {\n  idCounter++\n  return `${prefix}-${idCounter}`\n}\n\n/** Reset the ID counter (useful for tests) */\nexport function resetIdCounter(): void {\n  idCounter = 0\n}\n","/** Standard keyboard key constants */\nexport const Keys = {\n  Enter: 'Enter',\n  Space: ' ',\n  Escape: 'Escape',\n  Tab: 'Tab',\n  ArrowUp: 'ArrowUp',\n  ArrowDown: 'ArrowDown',\n  ArrowLeft: 'ArrowLeft',\n  ArrowRight: 'ArrowRight',\n  Home: 'Home',\n  End: 'End',\n  PageUp: 'PageUp',\n  PageDown: 'PageDown',\n  Backspace: 'Backspace',\n  Delete: 'Delete',\n} as const\n\nexport type KeyboardKey = (typeof Keys)[keyof typeof Keys]\n\n/** Map of key → handler function */\nexport type KeyboardHandlerMap = Partial<\n  Record<string, (event: KeyboardEvent) => void>\n>\n\n/** Create a keyboard event handler from a handler map */\nexport function createKeyboardHandler(\n  handlers: KeyboardHandlerMap,\n): (event: KeyboardEvent) => void {\n  return (event: KeyboardEvent) => {\n    const handler = handlers[event.key]\n    if (handler) {\n      handler(event)\n    }\n  }\n}\n","/**\n * Minimal state machine — zero dependencies, < 1KB.\n * Inspired by XState concepts but dramatically simpler.\n */\n\nexport interface MachineConfig<TState extends string, TEvent extends string> {\n  initial: TState\n  states: Record<TState, {\n    on?: Partial<Record<TEvent, TState>>\n  }>\n}\n\nexport interface Machine<TState extends string, TEvent extends string> {\n  /** Current state */\n  state: TState\n  /** Send an event to transition */\n  send(event: TEvent): void\n  /** Subscribe to state changes. Returns unsubscribe function. */\n  subscribe(fn: (state: TState) => void): () => void\n  /** Check if machine is in a given state */\n  matches(state: TState): boolean\n}\n\nexport function createMachine<TState extends string, TEvent extends string>(\n  config: MachineConfig<TState, TEvent>,\n): Machine<TState, TEvent> {\n  let current = config.initial\n  const listeners = new Set<(state: TState) => void>()\n\n  return {\n    get state() {\n      return current\n    },\n\n    send(event: TEvent) {\n      const stateConfig = config.states[current]\n      const next = stateConfig?.on?.[event]\n      if (next && next !== current) {\n        current = next\n        for (const fn of listeners) {\n          fn(current)\n        }\n      }\n    },\n\n    subscribe(fn: (state: TState) => void) {\n      listeners.add(fn)\n      return () => {\n        listeners.delete(fn)\n      }\n    },\n\n    matches(state: TState) {\n      return current === state\n    },\n  }\n}\n","/**\n * Lightweight class name utility — our own implementation.\n * Handles conditional classes, arrays, and falsy values.\n * No external dependencies (no clsx, no tailwind-merge).\n *\n * For Tailwind class conflict resolution (e.g., 'p-2 p-4' → 'p-4'),\n * consumers can use @refraction-ui/tailwind-config which provides\n * a tw-merge-aware variant of this function.\n */\n\ntype ClassValue = string | number | boolean | undefined | null | ClassValue[]\ntype ClassRecord = Record<string, boolean | undefined | null>\n\nexport function cn(...inputs: Array<ClassValue | ClassRecord>): string {\n  const classes: string[] = []\n\n  for (const input of inputs) {\n    if (!input) continue\n\n    if (typeof input === 'string') {\n      classes.push(input)\n    } else if (typeof input === 'number') {\n      classes.push(String(input))\n    } else if (Array.isArray(input)) {\n      const nested = cn(...input)\n      if (nested) classes.push(nested)\n    } else if (typeof input === 'object') {\n      for (const [key, value] of Object.entries(input)) {\n        if (value) classes.push(key)\n      }\n    }\n  }\n\n  return classes.join(' ')\n}\n","/**\n * Lightweight class-variance-authority alternative — zero dependencies.\n * Creates variant-driven class name functions for components.\n */\n\ninterface VariantConfig {\n  [variant: string]: Record<string, string>\n}\n\ninterface CVAConfig<V extends VariantConfig> {\n  base?: string\n  variants?: V\n  defaultVariants?: {\n    [K in keyof V]?: keyof V[K]\n  }\n  compoundVariants?: Array<\n    {\n      [K in keyof V]?: keyof V[K]\n    } & { class: string }\n  >\n}\n\ntype VariantProps<V extends VariantConfig> = {\n  [K in keyof V]?: keyof V[K]\n}\n\nexport function cva<V extends VariantConfig>(config: CVAConfig<V>) {\n  return (props?: VariantProps<V> & { className?: string }): string => {\n    const classes: string[] = []\n\n    if (config.base) {\n      classes.push(config.base)\n    }\n\n    if (config.variants) {\n      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {\n        const selectedValue =\n          (props as Record<string, unknown> | undefined)?.[variantKey] ??\n          config.defaultVariants?.[variantKey]\n\n        if (selectedValue != null) {\n          const variantClass = (variantOptions as Record<string, string>)[\n            selectedValue as string\n          ]\n          if (variantClass) {\n            classes.push(variantClass)\n          }\n        }\n      }\n    }\n\n    if (config.compoundVariants) {\n      for (const compound of config.compoundVariants) {\n        const { class: compoundClass, ...conditions } = compound\n        let matches = true\n\n        for (const [key, value] of Object.entries(conditions)) {\n          const propValue =\n            (props as Record<string, unknown>)?.[key] ??\n            config.defaultVariants?.[key]\n          if (propValue !== value) {\n            matches = false\n            break\n          }\n        }\n\n        if (matches) {\n          classes.push(compoundClass as string)\n        }\n      }\n    }\n\n    if (props?.className) {\n      classes.push(props.className)\n    }\n\n    return classes.filter(Boolean).join(' ')\n  }\n}\n","/**\n * dev-feedback — zero-dependency `devWarn` / `devError` primitives.\n *\n * Design constraints (epic #247, issue #248):\n * - Guarded by `process.env.NODE_ENV !== 'production'` so production bundlers\n *   dead-code-strip every call (the guard is a static string compare that\n *   minifiers fold to `false` in prod builds).\n * - Warn-once dedupe per `code` — a footgun is reported once, not on every\n *   render.\n * - NO import of `@refraction-ui/logger` (no hard dependency on the telemetry\n *   lib). Forwarding to a telemetry sink happens ONLY if the consumer\n *   explicitly injects one (dependency inversion, never an import).\n */\n\n/**\n * Minimal structural shape of the record a telemetry sink consumes. This is a\n * deliberate structural mirror of `@refraction-ui/logger`'s `LogRecord` — it is\n * NOT imported, so `@refraction-ui/shared` keeps zero dependency on the\n * telemetry lib. A consumer that wires the real logger sink satisfies this\n * shape structurally.\n */\nexport interface DevFeedbackRecord {\n  level: 'warn' | 'error'\n  message: string\n  timestamp: number\n  /** Structured detail — the library-origin envelope lives here. */\n  context: Record<string, unknown>\n}\n\n/**\n * The narrow contract a consumer-injected telemetry sink must satisfy. Kept\n * intentionally minimal and structural so the real `TelemetrySink` from\n * `@refraction-ui/logger` is assignable WITHOUT shared importing the logger.\n */\nexport interface DevFeedbackSink {\n  /** Receive a single dev-feedback record. Must never throw to the caller. */\n  log(record: DevFeedbackRecord): void\n}\n\n/**\n * Minimal ambient view of `process.env` so we can read `NODE_ENV` WITHOUT\n * pulling `@types/node` into this zero-dependency package. Accessed defensively\n * (the `typeof process === 'undefined'` guard) so this is safe in browsers too.\n */\ndeclare const process:\n  | { env?: { NODE_ENV?: string } }\n  | undefined\n\n/** Per-code dedupe set — module-scoped so it survives across calls. */\nconst seen = new Set<string>()\n\n/**\n * Optional, consumer-injected sink. `null` until a consumer explicitly wires\n * one via {@link setDevFeedbackSink}. Nothing phones home implicitly.\n */\nlet injectedSink: DevFeedbackSink | null = null\n\n/**\n * Wire an optional telemetry sink that {@link devWarn} / {@link devError}\n * forward to (in addition to the console). Inversion of control: the consumer\n * owns the sink; this package never imports it. Pass `null` to unwire.\n *\n * Forwarding still only happens in non-production (the calls themselves are\n * stripped in prod), and still respects warn-once dedupe.\n */\nexport function setDevFeedbackSink(sink: DevFeedbackSink | null): void {\n  injectedSink = sink\n}\n\n/** Test-only / consumer-only escape hatch to reset warn-once dedupe state. */\nexport function resetDevFeedback(): void {\n  seen.clear()\n}\n\nfunction isDev(): boolean {\n  // String compare (not a negated truthiness) so bundlers can statically fold\n  // `process.env.NODE_ENV` and strip the whole branch in production builds.\n  return (\n    typeof process === 'undefined' ||\n    process.env?.NODE_ENV !== 'production'\n  )\n}\n\nfunction emit(\n  level: 'warn' | 'error',\n  code: string,\n  message: string,\n  detail?: Record<string, unknown>,\n): void {\n  if (!isDev()) return\n\n  // Warn-once dedupe, keyed by (level, code) so an error and a warning sharing\n  // a code are not collapsed into one.\n  const key = `${level}:${code}`\n  if (seen.has(key)) return\n  seen.add(key)\n\n  const text = `[refraction-ui] ${code}: ${message}`\n\n  if (level === 'error') {\n    console.error(text, detail ?? '')\n  } else {\n    console.warn(text, detail ?? '')\n  }\n\n  // Forward to the consumer-injected sink ONLY if one was explicitly wired.\n  if (injectedSink) {\n    const record: DevFeedbackRecord = {\n      level,\n      message: `${code}: ${message}`,\n      timestamp: Date.now(),\n      context: { code, ...(detail ?? {}) },\n    }\n    try {\n      injectedSink.log(record)\n    } catch {\n      // A broken sink must never break the consumer app.\n    }\n  }\n}\n\n/**\n * Emit a development-only warning for a refraction-ui footgun.\n *\n * @param code    Stable, greppable identifier (e.g. `'react/no-controlled-prop'`).\n * @param message Human-readable explanation.\n * @param detail  Optional structured detail (forwarded to an injected sink).\n *\n * Stripped entirely in production. Warned at most once per `code`.\n */\nexport function devWarn(\n  code: string,\n  message: string,\n  detail?: Record<string, unknown>,\n): void {\n  emit('warn', code, message, detail)\n}\n\n/**\n * Emit a development-only error for a refraction-ui misuse / invariant break.\n *\n * @param code    Stable, greppable identifier.\n * @param message Human-readable explanation.\n * @param detail  Optional structured detail (forwarded to an injected sink).\n *\n * Stripped entirely in production. Reported at most once per `code`.\n */\nexport function devError(\n  code: string,\n  message: string,\n  detail?: Record<string, unknown>,\n): void {\n  emit('error', code, message, detail)\n}\n"]}

package/dist/chunk-XWP763SH.js

@@ -0,0 +1,76 @@
+// ../logger/dist/chunk-57LG5ZUS.js
+var FARO_LEVEL = {
+  debug: "debug",
+  info: "info",
+  warn: "warn",
+  error: "error",
+  fatal: "error"
+};
+async function createFaroSink(opts) {
+  const transport = opts.transport ?? await loadFaroTransport(opts);
+  if (!transport) return null;
+  return {
+    name: "faro",
+    log(record) {
+      transport.push({ kind: "log", record });
+    },
+    span(record) {
+      transport.push({ kind: "span", record });
+    },
+    async flush() {
+    }
+  };
+}
+async function loadFaroTransport(opts) {
+  try {
+    const sdkName = "@grafana/faro-web-sdk";
+    const tracingName = "@grafana/faro-web-tracing";
+    const sdk = await import(
+      /* @vite-ignore */
+      sdkName
+    );
+    const tracing = await import(
+      /* @vite-ignore */
+      tracingName
+    );
+    const faro = sdk.initializeFaro({
+      url: opts.endpoint,
+      app: { name: opts.app },
+      instrumentations: [
+        ...sdk.getWebInstrumentations(),
+        new tracing.TracingInstrumentation()
+      ]
+    });
+    return {
+      push({ kind, record }) {
+        if (kind === "log") {
+          const r = record;
+          faro.api.pushLog([r.message], {
+            level: FARO_LEVEL[r.level],
+            context: flatten(r.context)
+          });
+        } else {
+          const r = record;
+          faro.api.pushEvent(`span:${r.name}`, {
+            durationMs: String(r.durationMs),
+            status: r.status,
+            ...flatten(r.context)
+          });
+        }
+      }
+    };
+  } catch {
+    return null;
+  }
+}
+function flatten(ctx) {
+  const out = {};
+  for (const [k, v] of Object.entries(ctx)) {
+    out[k] = typeof v === "string" ? v : JSON.stringify(v);
+  }
+  return out;
+}
+
+export { createFaroSink };
+//# sourceMappingURL=chunk-XWP763SH.js.map
+//# sourceMappingURL=chunk-XWP763SH.js.map

package/dist/chunk-XWP763SH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../logger/src/faro-engine.ts"],"names":[],"mappings":";AA4BA,IAAM,UAAA,GAAuC;EAC3C,KAAA,EAAO,OAAA;EACP,IAAA,EAAM,MAAA;EACN,IAAA,EAAM,MAAA;EACN,KAAA,EAAO,OAAA;EACP,KAAA,EAAO;AACT,CAAA;AAOA,eAAsB,eACpB,IAAA,EAC+B;AAC/B,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,SAAA,IAAc,MAAM,kBAAkB,IAAI,CAAA;AACjE,EAAA,IAAI,CAAC,WAAW,OAAO,IAAA;AAEvB,EAAA,OAAO;IACL,IAAA,EAAM,MAAA;AAEN,IAAA,GAAA,CAAI,MAAA,EAAyB;AAC3B,MAAA,SAAA,CAAU,IAAA,CAAK,EAAE,IAAA,EAAM,KAAA,EAAO,QAAQ,CAAA;AACxC,IAAA,CAAA;AAEA,IAAA,IAAA,CAAK,MAAA,EAA0B;AAC7B,MAAA,SAAA,CAAU,IAAA,CAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,QAAQ,CAAA;AACzC,IAAA,CAAA;AAEA,IAAA,MAAM,KAAA,GAAuB;AAG7B,IAAA;AAAA,GAAA;AAEJ;AAMA,eAAe,kBACb,IAAA,EAC+B;AAC/B,EAAA,IAAI;AAEF,IAAA,MAAM,OAAA,GAAU,uBAAA;AAChB,IAAA,MAAM,WAAA,GAAc,2BAAA;AACpB,IAAA,MAAM,MAAO,MAAM;;AAA0B,MAAA;;AAI7C,IAAA,MAAM,UAAW,MAAM;;AAA0B,MAAA;;AAIjD,IAAA,MAAM,IAAA,GAAO,IAAI,cAAA,CAAe;AAC9B,MAAA,GAAA,EAAK,IAAA,CAAK,QAAA;MACV,GAAA,EAAK,EAAE,IAAA,EAAM,IAAA,CAAK,GAAA,EAAA;MAClB,gBAAA,EAAkB;AAChB,QAAA,GAAG,IAAI,sBAAA,EAAA;AACP,QAAA,IAAI,QAAQ,sBAAA;AAAuB;KAEtC,CAAA;AAOD,IAAA,OAAO;MACL,IAAA,CAAK,EAAE,IAAA,EAAM,MAAA,EAAA,EAAgB;AAC3B,QAAA,IAAI,SAAS,KAAA,EAAO;AAClB,UAAA,MAAM,CAAA,GAAI,MAAA;AACV,UAAA,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAA,CAAE,OAAO,CAAA,EAAG;YAC5B,KAAA,EAAO,UAAA,CAAW,EAAE,KAAK,CAAA;YACzB,OAAA,EAAS,OAAA,CAAQ,EAAE,OAAO;WAC3B,CAAA;QACH,CAAA,MAAO;AACL,UAAA,MAAM,CAAA,GAAI,MAAA;AACV,UAAA,IAAA,CAAK,GAAA,CAAI,SAAA,CAAU,CAAA,KAAA,EAAQ,CAAA,CAAE,IAAI,CAAA,CAAA,EAAI;YACnC,UAAA,EAAY,MAAA,CAAO,EAAE,UAAU,CAAA;AAC/B,YAAA,MAAA,EAAQ,CAAA,CAAE,MAAA;YACV,GAAG,OAAA,CAAQ,EAAE,OAAO;WACrB,CAAA;AACH,QAAA;AACF,MAAA;AAAA,KAAA;EAEJ,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,IAAA;AACT,EAAA;AACF;AAGA,SAAS,QAAQ,GAAA,EAAsD;AACrE,EAAA,MAAM,MAA8B,EAAA;AACpC,EAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA,EAAG;AACxC,IAAA,GAAA,CAAI,CAAC,IAAI,OAAO,CAAA,KAAM,WAAW,CAAA,GAAI,IAAA,CAAK,UAAU,CAAC,CAAA;AACvD,EAAA;AACA,EAAA,OAAO,GAAA;AACT","file":"chunk-XWP763SH.js","sourcesContent":["import type { LogLevel, LogRecord, SpanRecord, TelemetrySink } from './types.js'\n\n/**\n * Faro-backed engine. `@grafana/faro-web-sdk` + `@grafana/faro-web-tracing`\n * are **optional peerDependencies** — they are loaded dynamically and never\n * referenced in this module's public types. If the peers are absent the\n * factory resolves to `null` so the caller can fall back to console.\n *\n * For tests, a `transport` may be injected: an object with a `push(payload)`\n * method. This bypasses Faro entirely (no network, no peer required).\n */\n\n/** Minimal structural shape of a Faro-ish transport. Not exported. */\ninterface FaroTransport {\n  push(payload: { kind: 'log' | 'span'; record: LogRecord | SpanRecord }): void\n}\n\nexport interface FaroEngineOptions {\n  app: string\n  endpoint: string\n  /**\n   * Test/override transport. When provided, the Faro peers are NOT loaded\n   * and records are forwarded straight to `transport.push`.\n   */\n  transport?: FaroTransport\n}\n\n/** Map our levels onto Faro's log-level strings. */\nconst FARO_LEVEL: Record<LogLevel, string> = {\n  debug: 'debug',\n  info: 'info',\n  warn: 'warn',\n  error: 'error',\n  fatal: 'error',\n}\n\n/**\n * Construct the Faro engine. Returns `null` when the optional peers are not\n * installed and no override transport was supplied — callers treat `null` as\n * \"fall back to console\".\n */\nexport async function createFaroSink(\n  opts: FaroEngineOptions,\n): Promise<TelemetrySink | null> {\n  const transport = opts.transport ?? (await loadFaroTransport(opts))\n  if (!transport) return null\n\n  return {\n    name: 'faro',\n\n    log(record: LogRecord): void {\n      transport.push({ kind: 'log', record })\n    },\n\n    span(record: SpanRecord): void {\n      transport.push({ kind: 'span', record })\n    },\n\n    async flush(): Promise<void> {\n      // Faro's own transports flush on their schedule / on beacon; the\n      // manager drives page-exit beacon flushing. Nothing buffered here.\n    },\n  }\n}\n\n/**\n * Dynamically import the Faro peers and adapt them to {@link FaroTransport}.\n * Returns `null` if either peer is missing (optional peerDependency absent).\n */\nasync function loadFaroTransport(\n  opts: FaroEngineOptions,\n): Promise<FaroTransport | null> {\n  try {\n    // Indirected so bundlers keep these as runtime-optional dynamic imports.\n    const sdkName = '@grafana/faro-web-sdk'\n    const tracingName = '@grafana/faro-web-tracing'\n    const sdk = (await import(/* @vite-ignore */ sdkName)) as {\n      initializeFaro: (cfg: unknown) => unknown\n      getWebInstrumentations: () => unknown[]\n    }\n    const tracing = (await import(/* @vite-ignore */ tracingName)) as {\n      TracingInstrumentation: new () => unknown\n    }\n\n    const faro = sdk.initializeFaro({\n      url: opts.endpoint,\n      app: { name: opts.app },\n      instrumentations: [\n        ...sdk.getWebInstrumentations(),\n        new tracing.TracingInstrumentation(),\n      ],\n    }) as {\n      api: {\n        pushLog: (msgs: unknown[], opts?: unknown) => void\n        pushEvent: (name: string, attrs?: Record<string, unknown>) => void\n      }\n    }\n\n    return {\n      push({ kind, record }): void {\n        if (kind === 'log') {\n          const r = record as LogRecord\n          faro.api.pushLog([r.message], {\n            level: FARO_LEVEL[r.level],\n            context: flatten(r.context),\n          })\n        } else {\n          const r = record as SpanRecord\n          faro.api.pushEvent(`span:${r.name}`, {\n            durationMs: String(r.durationMs),\n            status: r.status,\n            ...flatten(r.context),\n          })\n        }\n      },\n    }\n  } catch {\n    // Peer not installed (optional) or init failed — caller falls back.\n    return null\n  }\n}\n\n/** Faro context attributes are flat string maps; coerce ours to match. */\nfunction flatten(ctx: Record<string, unknown>): Record<string, string> {\n  const out: Record<string, string> = {}\n  for (const [k, v] of Object.entries(ctx)) {\n    out[k] = typeof v === 'string' ? v : JSON.stringify(v)\n  }\n  return out\n}\n"]}

package/dist/faro-engine-47HGRAQH-JKINJPMH.js

@@ -0,0 +1,3 @@
+export { createFaroSink } from './chunk-XWP763SH.js';
+//# sourceMappingURL=faro-engine-47HGRAQH-JKINJPMH.js.map
+//# sourceMappingURL=faro-engine-47HGRAQH-JKINJPMH.js.map

package/dist/faro-engine-47HGRAQH-JKINJPMH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"faro-engine-47HGRAQH-JKINJPMH.js"}

package/dist/form.cjs

@@ -0,0 +1,340 @@
+'use strict';
+
+var React2 = require('react');
+var reactHookForm = require('react-hook-form');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React2__namespace = /*#__PURE__*/_interopNamespace(React2);
+
+// ../react-form/dist/index.js
+
+// ../shared/dist/index.js
+function cn(...inputs) {
+  const classes = [];
+  for (const input of inputs) {
+    if (!input) continue;
+    if (typeof input === "string") {
+      classes.push(input);
+    } else if (typeof input === "number") {
+      classes.push(String(input));
+    } else if (Array.isArray(input)) {
+      const nested = cn(...input);
+      if (nested) classes.push(nested);
+    } else if (typeof input === "object") {
+      for (const [key, value] of Object.entries(input)) {
+        if (value) classes.push(key);
+      }
+    }
+  }
+  return classes.join(" ");
+}
+function cva(config) {
+  return (props) => {
+    const classes = [];
+    if (config.base) {
+      classes.push(config.base);
+    }
+    if (config.variants) {
+      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {
+        const selectedValue = props?.[variantKey] ?? config.defaultVariants?.[variantKey];
+        if (selectedValue != null) {
+          const variantClass = variantOptions[selectedValue];
+          if (variantClass) {
+            classes.push(variantClass);
+          }
+        }
+      }
+    }
+    if (config.compoundVariants) {
+      for (const compound of config.compoundVariants) {
+        const { class: compoundClass, ...conditions } = compound;
+        let matches = true;
+        for (const [key, value] of Object.entries(conditions)) {
+          const propValue = props?.[key] ?? config.defaultVariants?.[key];
+          if (propValue !== value) {
+            matches = false;
+            break;
+          }
+        }
+        if (matches) {
+          classes.push(compoundClass);
+        }
+      }
+    }
+    if (props?.className) {
+      classes.push(props.className);
+    }
+    return classes.filter(Boolean).join(" ");
+  };
+}
+var seen = /* @__PURE__ */ new Set();
+function isDev() {
+  return typeof process === "undefined" || process.env?.NODE_ENV !== "production";
+}
+function emit(level, code, message, detail) {
+  if (!isDev()) return;
+  const key = `${level}:${code}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  const text = `[refraction-ui] ${code}: ${message}`;
+  {
+    console.warn(text, "");
+  }
+}
+function devWarn(code, message, detail) {
+  emit("warn", code, message);
+}
+var Slot = React2__namespace.forwardRef(function Slot2(props, forwardedRef) {
+  const { children, ...slotProps } = props;
+  if (!React2__namespace.isValidElement(children)) {
+    return null;
+  }
+  const childProps = children.props ?? {};
+  const mergedProps = mergeProps(slotProps, childProps);
+  let childRef = childProps.ref;
+  if (childRef === void 0 && !("ref" in childProps)) {
+    childRef = children.ref;
+  }
+  const mergedRef = composeRefs(forwardedRef, childRef);
+  return React2__namespace.cloneElement(
+    children,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    { ...mergedProps, ref: mergedRef }
+  );
+});
+Slot.displayName = "Slot";
+function mergeProps(slotProps, childProps) {
+  const merged = { ...slotProps };
+  for (const key of Object.keys(childProps)) {
+    const slotValue = slotProps[key];
+    const childValue = childProps[key];
+    if (/^on[A-Z]/.test(key) && typeof slotValue === "function" && typeof childValue === "function") {
+      merged[key] = (...args) => {
+        const child = childValue;
+        const slot = slotValue;
+        child(...args);
+        slot(...args);
+      };
+    } else if (key === "className") {
+      merged[key] = [slotValue, childValue].filter(Boolean).join(" ");
+    } else if (key === "style") {
+      merged[key] = { ...slotValue, ...childValue };
+    } else if (childValue !== void 0) {
+      merged[key] = childValue;
+    }
+  }
+  return merged;
+}
+function composeRefs(...refs) {
+  return (node) => {
+    for (const ref of refs) {
+      if (typeof ref === "function") {
+        ref(node);
+      } else if (ref != null) {
+        const objectRef = ref;
+        objectRef.current = node;
+      }
+    }
+  };
+}
+var Form = reactHookForm.FormProvider;
+var FormFieldContext = React2__namespace.createContext(
+  void 0
+);
+var FormItemContext = React2__namespace.createContext(
+  void 0
+);
+function FormField(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx(FormFieldContext.Provider, { value: { name: props.name }, children: /* @__PURE__ */ jsxRuntime.jsx(reactHookForm.Controller, { ...props }) });
+}
+function useFormField() {
+  const fieldContext = React2__namespace.useContext(FormFieldContext);
+  const itemContext = React2__namespace.useContext(FormItemContext);
+  const formContext = reactHookForm.useFormContext();
+  const { errors } = reactHookForm.useFormState({
+    control: formContext?.control,
+    name: fieldContext?.name,
+    exact: true
+  });
+  if (!fieldContext) {
+    devWarn(
+      "react-form/use-form-field-outside-form-field",
+      "useFormField (via FormLabel/FormControl/FormDescription/FormMessage) must be used inside a <FormField>. The missing FormFieldContext makes this throw."
+    );
+    throw new Error("useFormField must be used within a <FormField>");
+  }
+  if (!itemContext) {
+    devWarn(
+      "react-form/use-form-field-outside-form-item",
+      "useFormField (via FormLabel/FormControl/FormDescription/FormMessage) must be used inside a <FormItem>. The missing FormItemContext makes this throw."
+    );
+    throw new Error("useFormField must be used within a <FormItem>");
+  }
+  const { id } = itemContext;
+  const error = getNestedError(errors, fieldContext.name);
+  return {
+    id,
+    name: fieldContext.name,
+    formItemId: `${id}-form-item`,
+    formDescriptionId: `${id}-form-item-description`,
+    formMessageId: `${id}-form-item-message`,
+    error,
+    invalid: Boolean(error)
+  };
+}
+function getNestedError(errors, name) {
+  if (!errors) return void 0;
+  const segments = name.replace(/\[(\w+)\]/g, ".$1").split(".");
+  let cursor = errors;
+  for (const seg of segments) {
+    if (cursor && typeof cursor === "object" && seg in cursor) {
+      cursor = cursor[seg];
+    } else {
+      return void 0;
+    }
+  }
+  return cursor;
+}
+var formItemVariants = cva({ base: "space-y-2" });
+var FormItem = React2__namespace.forwardRef(
+  ({ className, ...props }, ref) => {
+    const id = React2__namespace.useId();
+    return /* @__PURE__ */ jsxRuntime.jsx(FormItemContext.Provider, { value: { id }, children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn(formItemVariants(), className), ...props }) });
+  }
+);
+FormItem.displayName = "FormItem";
+var formLabelVariants = cva({
+  base: "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
+  variants: {
+    invalid: {
+      true: "text-destructive",
+      false: ""
+    }
+  },
+  defaultVariants: {
+    invalid: "false"
+  }
+});
+var FormLabel = React2__namespace.forwardRef(
+  ({ className, ...props }, ref) => {
+    const { invalid, formItemId } = useFormField();
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "label",
+      {
+        ref,
+        htmlFor: formItemId,
+        "data-invalid": invalid ? "" : void 0,
+        className: cn(formLabelVariants({ invalid: invalid ? "true" : "false" }), className),
+        ...props
+      }
+    );
+  }
+);
+FormLabel.displayName = "FormLabel";
+var FormControl = React2__namespace.forwardRef(
+  ({ ...props }, ref) => {
+    const { invalid, formItemId, formDescriptionId, formMessageId } = useFormField();
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      Slot,
+      {
+        ref,
+        id: formItemId,
+        "aria-describedby": invalid ? `${formDescriptionId} ${formMessageId}` : formDescriptionId,
+        "aria-invalid": invalid || void 0,
+        ...props
+      }
+    );
+  }
+);
+FormControl.displayName = "FormControl";
+var FormDescription = React2__namespace.forwardRef(({ className, ...props }, ref) => {
+  const { formDescriptionId } = useFormField();
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "p",
+    {
+      ref,
+      id: formDescriptionId,
+      className: cn("text-sm text-muted-foreground", className),
+      ...props
+    }
+  );
+});
+FormDescription.displayName = "FormDescription";
+var FormMessage = React2__namespace.forwardRef(
+  ({ className, children, ...props }, ref) => {
+    const { error, formMessageId } = useFormField();
+    const body = error?.message ? String(error.message) : children;
+    if (!body) return null;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "p",
+      {
+        ref,
+        id: formMessageId,
+        className: cn("text-sm font-medium text-destructive", className),
+        ...props,
+        children: body
+      }
+    );
+  }
+);
+FormMessage.displayName = "FormMessage";
+
+Object.defineProperty(exports, "Controller", {
+  enumerable: true,
+  get: function () { return reactHookForm.Controller; }
+});
+Object.defineProperty(exports, "FormProvider", {
+  enumerable: true,
+  get: function () { return reactHookForm.FormProvider; }
+});
+Object.defineProperty(exports, "useController", {
+  enumerable: true,
+  get: function () { return reactHookForm.useController; }
+});
+Object.defineProperty(exports, "useForm", {
+  enumerable: true,
+  get: function () { return reactHookForm.useForm; }
+});
+Object.defineProperty(exports, "useFormContext", {
+  enumerable: true,
+  get: function () { return reactHookForm.useFormContext; }
+});
+Object.defineProperty(exports, "useFormState", {
+  enumerable: true,
+  get: function () { return reactHookForm.useFormState; }
+});
+Object.defineProperty(exports, "useWatch", {
+  enumerable: true,
+  get: function () { return reactHookForm.useWatch; }
+});
+exports.Form = Form;
+exports.FormControl = FormControl;
+exports.FormDescription = FormDescription;
+exports.FormField = FormField;
+exports.FormItem = FormItem;
+exports.FormLabel = FormLabel;
+exports.FormMessage = FormMessage;
+exports.Slot = Slot;
+exports.formItemVariants = formItemVariants;
+exports.formLabelVariants = formLabelVariants;
+exports.useFormField = useFormField;
+//# sourceMappingURL=form.cjs.map
+//# sourceMappingURL=form.cjs.map