@refraction-ui/react 0.5.0 → 0.6.0

package/dist/internal/shared/index.d.cts

@@ -188,6 +188,176 @@ declare function createSkipLink(props?: SkipLinkProps): {
     className: string;
 };
 
+/**
+ * dev-feedback — zero-dependency `devWarn` / `devError` primitives.
+ *
+ * Design constraints (epic #247, issue #248):
+ * - Guarded by `process.env.NODE_ENV !== 'production'` so production bundlers
+ *   dead-code-strip every call (the guard is a static string compare that
+ *   minifiers fold to `false` in prod builds).
+ * - Warn-once dedupe per `code` — a footgun is reported once, not on every
+ *   render.
+ * - NO import of `@refraction-ui/logger` (no hard dependency on the telemetry
+ *   lib). Forwarding to a telemetry sink happens ONLY if the consumer
+ *   explicitly injects one (dependency inversion, never an import).
+ */
+/**
+ * Minimal structural shape of the record a telemetry sink consumes. This is a
+ * deliberate structural mirror of `@refraction-ui/logger`'s `LogRecord` — it is
+ * NOT imported, so `@refraction-ui/shared` keeps zero dependency on the
+ * telemetry lib. A consumer that wires the real logger sink satisfies this
+ * shape structurally.
+ */
+interface DevFeedbackRecord {
+    level: 'warn' | 'error';
+    message: string;
+    timestamp: number;
+    /** Structured detail — the library-origin envelope lives here. */
+    context: Record<string, unknown>;
+}
+/**
+ * The narrow contract a consumer-injected telemetry sink must satisfy. Kept
+ * intentionally minimal and structural so the real `TelemetrySink` from
+ * `@refraction-ui/logger` is assignable WITHOUT shared importing the logger.
+ */
+interface DevFeedbackSink {
+    /** Receive a single dev-feedback record. Must never throw to the caller. */
+    log(record: DevFeedbackRecord): void;
+}
+/**
+ * Wire an optional telemetry sink that {@link devWarn} / {@link devError}
+ * forward to (in addition to the console). Inversion of control: the consumer
+ * owns the sink; this package never imports it. Pass `null` to unwire.
+ *
+ * Forwarding still only happens in non-production (the calls themselves are
+ * stripped in prod), and still respects warn-once dedupe.
+ */
+declare function setDevFeedbackSink(sink: DevFeedbackSink | null): void;
+/** Test-only / consumer-only escape hatch to reset warn-once dedupe state. */
+declare function resetDevFeedback(): void;
+/**
+ * Emit a development-only warning for a refraction-ui footgun.
+ *
+ * @param code    Stable, greppable identifier (e.g. `'react/no-controlled-prop'`).
+ * @param message Human-readable explanation.
+ * @param detail  Optional structured detail (forwarded to an injected sink).
+ *
+ * Stripped entirely in production. Warned at most once per `code`.
+ */
+declare function devWarn(code: string, message: string, detail?: Record<string, unknown>): void;
+/**
+ * Emit a development-only error for a refraction-ui misuse / invariant break.
+ *
+ * @param code    Stable, greppable identifier.
+ * @param message Human-readable explanation.
+ * @param detail  Optional structured detail (forwarded to an injected sink).
+ *
+ * Stripped entirely in production. Reported at most once per `code`.
+ */
+declare function devError(code: string, message: string, detail?: Record<string, unknown>): void;
+
+/**
+ * library-origin-error — builds the **library-origin error envelope** for
+ * errors that originate inside a `@refraction-ui/*` package.
+ *
+ * The envelope is expressed THROUGH the existing telemetry record contract
+ * (`@refraction-ui/logger`'s `LogRecord`) — the contract is reused, NOT
+ * redefined. To keep `@refraction-ui/shared` zero-dependency, the record is
+ * mirrored structurally (see {@link DevFeedbackRecord}) rather than imported;
+ * a consumer wiring the real logger sink satisfies it structurally.
+ *
+ * Aggressive redaction (epic #247 guardrails): the payload is package,
+ * componentName, version, a normalized stack **fingerprint hash**, and
+ * framework only. Never app state, props values, user data, PII, or full app
+ * stack frames.
+ */
+
+/** Frameworks a refraction-ui adapter can run under. */
+type LibraryFramework = 'react' | 'angular' | 'astro' | 'vue' | 'svelte' | 'vanilla' | 'unknown';
+/** Inputs describing where a library-origin error came from. */
+interface LibraryOriginErrorInput {
+    /** Originating package, e.g. `@refraction-ui/react`. */
+    package: string;
+    /** refraction-ui component the error originated in, e.g. `Dialog`. */
+    componentName: string;
+    /** Originating package version, e.g. `0.1.5`. */
+    version: string;
+    /** Host framework the component was running under. */
+    framework: LibraryFramework;
+    /** The thrown error (or its stack string). Used ONLY to derive a hash. */
+    error?: unknown;
+}
+/**
+ * The redacted, library-origin payload carried in `LogRecord.context`. Contains
+ * NO app data — only the five identifying fields plus a stack fingerprint hash.
+ */
+interface LibraryOriginEnvelope {
+    /** Marks this record as a library-origin error (for downstream routing). */
+    origin: 'refraction-ui';
+    package: string;
+    componentName: string;
+    version: string;
+    framework: LibraryFramework;
+    /** Stable, app-data-free hash of the normalized stack. */
+    fingerprint: string;
+}
+/**
+ * Compute the stable stack fingerprint for a library-origin error. Exposed
+ * separately so capture seams / tests can assert fingerprint stability without
+ * building the whole record.
+ */
+declare function stackFingerprint(error: unknown): string;
+/**
+ * Build the redacted library-origin envelope for an error.
+ */
+declare function libraryOriginEnvelope(input: LibraryOriginErrorInput): LibraryOriginEnvelope;
+/**
+ * Build the full library-origin error record, expressed THROUGH the existing
+ * telemetry record contract (`LogRecord`, mirrored as {@link DevFeedbackRecord}
+ * to avoid a hard logger dependency). The redacted envelope rides in
+ * `context`; no app data, props, PII, or app stack frames are included.
+ *
+ * This record is exactly what a consumer-wired telemetry sink (or the
+ * `devWarn`/`devError` injected sink) consumes.
+ */
+declare function libraryOriginError(input: LibraryOriginErrorInput): DevFeedbackRecord;
+/**
+ * Library-origin predicate — `true` iff the error's stack contains at least
+ * one frame that references a `@refraction-ui/*` package. This is the gate
+ * every per-framework capture seam uses: only library-origin errors are
+ * eligible; the app's own errors return `false` and pass through untouched.
+ *
+ * Mirrors exactly the frame-detection rule {@link stackFingerprint} normalizes
+ * by — no new contract, just the companion predicate the seams need. Never
+ * throws for a missing/odd error (returns `false`).
+ */
+declare function isLibraryOriginError(error: unknown): boolean;
+/**
+ * The fixed identity of the refraction-ui package/component a seam tags an
+ * error with. The seam supplies this; the stack itself supplies the
+ * fingerprint. Never carries app data.
+ */
+type LibraryOriginIdentity = Pick<LibraryOriginErrorInput, 'package' | 'componentName' | 'version' | 'framework'>;
+/**
+ * The single capture primitive shared by every per-framework seam (React error
+ * boundary, Angular `ErrorHandler`, Astro middleware). It performs the entire
+ * guarded flow in one place so the seams stay thin and identical in behavior:
+ *
+ *  1. **Library-origin filter** — if the error's stack has no
+ *     `@refraction-ui/*` frame it is the app's own error: return `null` and do
+ *     NOT touch, capture, or forward it.
+ *  2. **Tag** — build the redacted {@link libraryOriginError} record
+ *     (package/componentName/version/framework + app-data-free fingerprint).
+ *  3. **Route to the optional sink** — forward the record to the
+ *     consumer-injected sink ONLY if one was wired; a broken sink can never
+ *     break the consumer app. With no sink this is a no-op beyond returning
+ *     the record (so a seam can still surface it locally).
+ *
+ * @returns the tagged record for a library-origin error, or `null` when the
+ *          error is app-origin (the "pass through untouched" signal).
+ */
+declare function captureLibraryOriginError(error: unknown, identity: LibraryOriginIdentity, sink: DevFeedbackSink | null | undefined): DevFeedbackRecord | null;
+
 /** Merge multiple ARIA prop objects, later values override earlier ones */
 declare function mergeAriaProps(...propSets: Array<Record<string, unknown>>): Record<string, unknown>;
 /**
@@ -246,4 +416,4 @@ declare function prefersReducedMotion(): boolean;
 /** Get animation duration — returns '0ms' if reduced motion preferred */
 declare function getAnimationDuration(normalDuration: string): string;
 
-export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, type EngineAdapter, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, generateId, getAnimationDuration, getFocusableElements, mergeAriaProps, prefersReducedMotion, resetIdCounter };
+export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, type DevFeedbackRecord, type DevFeedbackSink, type EngineAdapter, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LibraryFramework, type LibraryOriginEnvelope, type LibraryOriginErrorInput, type LibraryOriginIdentity, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, captureLibraryOriginError, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, devError, devWarn, generateId, getAnimationDuration, getFocusableElements, isLibraryOriginError, libraryOriginEnvelope, libraryOriginError, mergeAriaProps, prefersReducedMotion, resetDevFeedback, resetIdCounter, setDevFeedbackSink, stackFingerprint };

package/dist/internal/shared/index.d.ts

@@ -188,6 +188,176 @@ declare function createSkipLink(props?: SkipLinkProps): {
     className: string;
 };
 
+/**
+ * dev-feedback — zero-dependency `devWarn` / `devError` primitives.
+ *
+ * Design constraints (epic #247, issue #248):
+ * - Guarded by `process.env.NODE_ENV !== 'production'` so production bundlers
+ *   dead-code-strip every call (the guard is a static string compare that
+ *   minifiers fold to `false` in prod builds).
+ * - Warn-once dedupe per `code` — a footgun is reported once, not on every
+ *   render.
+ * - NO import of `@refraction-ui/logger` (no hard dependency on the telemetry
+ *   lib). Forwarding to a telemetry sink happens ONLY if the consumer
+ *   explicitly injects one (dependency inversion, never an import).
+ */
+/**
+ * Minimal structural shape of the record a telemetry sink consumes. This is a
+ * deliberate structural mirror of `@refraction-ui/logger`'s `LogRecord` — it is
+ * NOT imported, so `@refraction-ui/shared` keeps zero dependency on the
+ * telemetry lib. A consumer that wires the real logger sink satisfies this
+ * shape structurally.
+ */
+interface DevFeedbackRecord {
+    level: 'warn' | 'error';
+    message: string;
+    timestamp: number;
+    /** Structured detail — the library-origin envelope lives here. */
+    context: Record<string, unknown>;
+}
+/**
+ * The narrow contract a consumer-injected telemetry sink must satisfy. Kept
+ * intentionally minimal and structural so the real `TelemetrySink` from
+ * `@refraction-ui/logger` is assignable WITHOUT shared importing the logger.
+ */
+interface DevFeedbackSink {
+    /** Receive a single dev-feedback record. Must never throw to the caller. */
+    log(record: DevFeedbackRecord): void;
+}
+/**
+ * Wire an optional telemetry sink that {@link devWarn} / {@link devError}
+ * forward to (in addition to the console). Inversion of control: the consumer
+ * owns the sink; this package never imports it. Pass `null` to unwire.
+ *
+ * Forwarding still only happens in non-production (the calls themselves are
+ * stripped in prod), and still respects warn-once dedupe.
+ */
+declare function setDevFeedbackSink(sink: DevFeedbackSink | null): void;
+/** Test-only / consumer-only escape hatch to reset warn-once dedupe state. */
+declare function resetDevFeedback(): void;
+/**
+ * Emit a development-only warning for a refraction-ui footgun.
+ *
+ * @param code    Stable, greppable identifier (e.g. `'react/no-controlled-prop'`).
+ * @param message Human-readable explanation.
+ * @param detail  Optional structured detail (forwarded to an injected sink).
+ *
+ * Stripped entirely in production. Warned at most once per `code`.
+ */
+declare function devWarn(code: string, message: string, detail?: Record<string, unknown>): void;
+/**
+ * Emit a development-only error for a refraction-ui misuse / invariant break.
+ *
+ * @param code    Stable, greppable identifier.
+ * @param message Human-readable explanation.
+ * @param detail  Optional structured detail (forwarded to an injected sink).
+ *
+ * Stripped entirely in production. Reported at most once per `code`.
+ */
+declare function devError(code: string, message: string, detail?: Record<string, unknown>): void;
+
+/**
+ * library-origin-error — builds the **library-origin error envelope** for
+ * errors that originate inside a `@refraction-ui/*` package.
+ *
+ * The envelope is expressed THROUGH the existing telemetry record contract
+ * (`@refraction-ui/logger`'s `LogRecord`) — the contract is reused, NOT
+ * redefined. To keep `@refraction-ui/shared` zero-dependency, the record is
+ * mirrored structurally (see {@link DevFeedbackRecord}) rather than imported;
+ * a consumer wiring the real logger sink satisfies it structurally.
+ *
+ * Aggressive redaction (epic #247 guardrails): the payload is package,
+ * componentName, version, a normalized stack **fingerprint hash**, and
+ * framework only. Never app state, props values, user data, PII, or full app
+ * stack frames.
+ */
+
+/** Frameworks a refraction-ui adapter can run under. */
+type LibraryFramework = 'react' | 'angular' | 'astro' | 'vue' | 'svelte' | 'vanilla' | 'unknown';
+/** Inputs describing where a library-origin error came from. */
+interface LibraryOriginErrorInput {
+    /** Originating package, e.g. `@refraction-ui/react`. */
+    package: string;
+    /** refraction-ui component the error originated in, e.g. `Dialog`. */
+    componentName: string;
+    /** Originating package version, e.g. `0.1.5`. */
+    version: string;
+    /** Host framework the component was running under. */
+    framework: LibraryFramework;
+    /** The thrown error (or its stack string). Used ONLY to derive a hash. */
+    error?: unknown;
+}
+/**
+ * The redacted, library-origin payload carried in `LogRecord.context`. Contains
+ * NO app data — only the five identifying fields plus a stack fingerprint hash.
+ */
+interface LibraryOriginEnvelope {
+    /** Marks this record as a library-origin error (for downstream routing). */
+    origin: 'refraction-ui';
+    package: string;
+    componentName: string;
+    version: string;
+    framework: LibraryFramework;
+    /** Stable, app-data-free hash of the normalized stack. */
+    fingerprint: string;
+}
+/**
+ * Compute the stable stack fingerprint for a library-origin error. Exposed
+ * separately so capture seams / tests can assert fingerprint stability without
+ * building the whole record.
+ */
+declare function stackFingerprint(error: unknown): string;
+/**
+ * Build the redacted library-origin envelope for an error.
+ */
+declare function libraryOriginEnvelope(input: LibraryOriginErrorInput): LibraryOriginEnvelope;
+/**
+ * Build the full library-origin error record, expressed THROUGH the existing
+ * telemetry record contract (`LogRecord`, mirrored as {@link DevFeedbackRecord}
+ * to avoid a hard logger dependency). The redacted envelope rides in
+ * `context`; no app data, props, PII, or app stack frames are included.
+ *
+ * This record is exactly what a consumer-wired telemetry sink (or the
+ * `devWarn`/`devError` injected sink) consumes.
+ */
+declare function libraryOriginError(input: LibraryOriginErrorInput): DevFeedbackRecord;
+/**
+ * Library-origin predicate — `true` iff the error's stack contains at least
+ * one frame that references a `@refraction-ui/*` package. This is the gate
+ * every per-framework capture seam uses: only library-origin errors are
+ * eligible; the app's own errors return `false` and pass through untouched.
+ *
+ * Mirrors exactly the frame-detection rule {@link stackFingerprint} normalizes
+ * by — no new contract, just the companion predicate the seams need. Never
+ * throws for a missing/odd error (returns `false`).
+ */
+declare function isLibraryOriginError(error: unknown): boolean;
+/**
+ * The fixed identity of the refraction-ui package/component a seam tags an
+ * error with. The seam supplies this; the stack itself supplies the
+ * fingerprint. Never carries app data.
+ */
+type LibraryOriginIdentity = Pick<LibraryOriginErrorInput, 'package' | 'componentName' | 'version' | 'framework'>;
+/**
+ * The single capture primitive shared by every per-framework seam (React error
+ * boundary, Angular `ErrorHandler`, Astro middleware). It performs the entire
+ * guarded flow in one place so the seams stay thin and identical in behavior:
+ *
+ *  1. **Library-origin filter** — if the error's stack has no
+ *     `@refraction-ui/*` frame it is the app's own error: return `null` and do
+ *     NOT touch, capture, or forward it.
+ *  2. **Tag** — build the redacted {@link libraryOriginError} record
+ *     (package/componentName/version/framework + app-data-free fingerprint).
+ *  3. **Route to the optional sink** — forward the record to the
+ *     consumer-injected sink ONLY if one was wired; a broken sink can never
+ *     break the consumer app. With no sink this is a no-op beyond returning
+ *     the record (so a seam can still surface it locally).
+ *
+ * @returns the tagged record for a library-origin error, or `null` when the
+ *          error is app-origin (the "pass through untouched" signal).
+ */
+declare function captureLibraryOriginError(error: unknown, identity: LibraryOriginIdentity, sink: DevFeedbackSink | null | undefined): DevFeedbackRecord | null;
+
 /** Merge multiple ARIA prop objects, later values override earlier ones */
 declare function mergeAriaProps(...propSets: Array<Record<string, unknown>>): Record<string, unknown>;
 /**
@@ -246,4 +416,4 @@ declare function prefersReducedMotion(): boolean;
 /** Get animation duration — returns '0ms' if reduced motion preferred */
 declare function getAnimationDuration(normalDuration: string): string;
 
-export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, type EngineAdapter, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, generateId, getAnimationDuration, getFocusableElements, mergeAriaProps, prefersReducedMotion, resetIdCounter };
+export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, type DevFeedbackRecord, type DevFeedbackSink, type EngineAdapter, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LibraryFramework, type LibraryOriginEnvelope, type LibraryOriginErrorInput, type LibraryOriginIdentity, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, captureLibraryOriginError, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, devError, devWarn, generateId, getAnimationDuration, getFocusableElements, isLibraryOriginError, libraryOriginEnvelope, libraryOriginError, mergeAriaProps, prefersReducedMotion, resetDevFeedback, resetIdCounter, setDevFeedbackSink, stackFingerprint };

package/dist/theme.cjs

@@ -137,6 +137,25 @@ function applyThemeToDOM(resolved, attribute = "class") {
   root.style.colorScheme = resolved;
 }
 
+// ../shared/dist/index.js
+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);
+}
+
 // ../react-theme/dist/index.js
 var ThemeContext = React2__namespace.createContext(null);
 function ThemeProvider({
@@ -180,6 +199,10 @@ function ThemeProvider({
 function useTheme() {
   const context = React2__namespace.useContext(ThemeContext);
   if (!context) {
+    devWarn(
+      "react-theme/use-theme-outside-provider",
+      "useTheme() was called outside a <ThemeProvider>. Wrap your app (or the consuming subtree) in <ThemeProvider> so the theme context is available."
+    );
     throw new Error("useTheme must be used within a <ThemeProvider>");
   }
   return context;

package/dist/theme.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../theme/src/theme-machine.ts","../../theme/src/theme-script.ts","../../theme/src/dom-adapters.ts","../../react-theme/src/theme-provider.tsx","../../react-theme/src/theme-toggle.tsx","../../react-theme/src/theme-script-component.tsx"],"names":["React","React2","React3"],"mappings":"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","file":"theme.cjs","sourcesContent":["/**\n * Headless theme state machine — pure TypeScript, zero DOM dependencies.\n * Manages light/dark/system mode with system preference tracking.\n */\n\nexport type ThemeMode = 'light' | 'dark' | 'system'\nexport type ResolvedTheme = 'light' | 'dark'\n\nexport interface ThemeState {\n  /** User's chosen mode */\n  mode: ThemeMode\n  /** Resolved theme after system preference detection */\n  resolved: ResolvedTheme\n}\n\nexport interface ThemeConfig {\n  /** Initial mode. Default: 'system' */\n  defaultMode?: ThemeMode\n  /** localStorage key. Default: 'rfr-theme' */\n  storageKey?: string\n  /** HTML attribute to set. Default: 'class' */\n  attribute?: 'class' | 'data-theme'\n}\n\nexport interface StorageAdapter {\n  get(key: string): string | null\n  set(key: string, value: string): void\n}\n\nexport interface MediaQueryAdapter {\n  matches(query: string): boolean\n  subscribe(query: string, callback: (matches: boolean) => void): () => void\n}\n\nexport interface ThemeAPI {\n  /** Get current state */\n  getState(): ThemeState\n  /** Set mode (light/dark/system) */\n  setMode(mode: ThemeMode): void\n  /** Subscribe to state changes */\n  subscribe(fn: (state: ThemeState) => void): () => void\n  /** Clean up subscriptions */\n  destroy(): void\n}\n\nfunction resolveTheme(mode: ThemeMode, systemPrefersDark: boolean): ResolvedTheme {\n  if (mode === 'system') {\n    return systemPrefersDark ? 'dark' : 'light'\n  }\n  return mode\n}\n\nexport function createTheme(\n  config: ThemeConfig = {},\n  storage?: StorageAdapter,\n  mediaQuery?: MediaQueryAdapter,\n): ThemeAPI {\n  const {\n    defaultMode = 'system',\n    storageKey = 'rfr-theme',\n  } = config\n\n  const listeners = new Set<(state: ThemeState) => void>()\n  let cleanupMediaQuery: (() => void) | null = null\n\n  // Read persisted mode or use default\n  const persisted = storage?.get(storageKey) as ThemeMode | null\n  let mode: ThemeMode = persisted && ['light', 'dark', 'system'].includes(persisted)\n    ? persisted\n    : defaultMode\n\n  // Detect system preference\n  let systemPrefersDark = mediaQuery?.matches('(prefers-color-scheme: dark)') ?? false\n\n  let state: ThemeState = {\n    mode,\n    resolved: resolveTheme(mode, systemPrefersDark),\n  }\n\n  function notify() {\n    for (const fn of listeners) {\n      fn(state)\n    }\n  }\n\n  function updateState(newMode: ThemeMode) {\n    mode = newMode\n    state = { mode, resolved: resolveTheme(mode, systemPrefersDark) }\n    storage?.set(storageKey, mode)\n    notify()\n  }\n\n  // Listen for system preference changes\n  if (mediaQuery) {\n    cleanupMediaQuery = mediaQuery.subscribe(\n      '(prefers-color-scheme: dark)',\n      (matches) => {\n        systemPrefersDark = matches\n        if (mode === 'system') {\n          state = { mode, resolved: resolveTheme(mode, systemPrefersDark) }\n          notify()\n        }\n      },\n    )\n  }\n\n  return {\n    getState() {\n      return state\n    },\n\n    setMode(newMode: ThemeMode) {\n      if (newMode !== mode) {\n        updateState(newMode)\n      }\n    },\n\n    subscribe(fn: (state: ThemeState) => void) {\n      listeners.add(fn)\n      return () => {\n        listeners.delete(fn)\n      }\n    },\n\n    destroy() {\n      listeners.clear()\n      cleanupMediaQuery?.()\n    },\n  }\n}\n","/**\n * Inline script for preventing theme flash on page load.\n * Inject this as a <script> tag in the <head> before any CSS.\n * Works with any framework (React, Angular, Astro, plain HTML).\n */\n\nexport function getThemeScript(\n  storageKey = 'rfr-theme',\n  attribute: 'class' | 'data-theme' = 'class',\n): string {\n  // This string is injected as innerHTML of a <script> tag.\n  // It runs before any CSS/JS loads, preventing flash of wrong theme.\n  return `(function(){try{var m=localStorage.getItem('${storageKey}');var s=window.matchMedia('(prefers-color-scheme:dark)').matches;var t=m==='dark'||(m!=='light'&&s)?'dark':'light';var d=document.documentElement;${\n    attribute === 'class'\n      ? \"d.classList.remove('light','dark');d.classList.add(t);\"\n      : `d.setAttribute('${attribute}',t);`\n  }d.style.colorScheme=t;}catch(e){}})()`\n}\n","/**\n * Browser DOM adapters for the theme machine.\n * These bridge the headless core to browser APIs.\n */\n\nimport type { StorageAdapter, MediaQueryAdapter, ResolvedTheme } from './theme-machine.js'\n\n/** localStorage adapter */\nexport function createLocalStorageAdapter(): StorageAdapter {\n  return {\n    get(key) {\n      try {\n        return localStorage.getItem(key)\n      } catch {\n        return null\n      }\n    },\n    set(key, value) {\n      try {\n        localStorage.setItem(key, value)\n      } catch {\n        // localStorage unavailable (SSR, incognito quota exceeded, etc.)\n      }\n    },\n  }\n}\n\n/** matchMedia adapter */\nexport function createMediaQueryAdapter(): MediaQueryAdapter {\n  return {\n    matches(query) {\n      if (typeof window === 'undefined') return false\n      return window.matchMedia(query).matches\n    },\n    subscribe(query, callback) {\n      if (typeof window === 'undefined') return () => {}\n      const mql = window.matchMedia(query)\n      const handler = (e: MediaQueryListEvent) => callback(e.matches)\n      mql.addEventListener('change', handler)\n      return () => mql.removeEventListener('change', handler)\n    },\n  }\n}\n\n/** Apply resolved theme to the document */\nexport function applyThemeToDOM(\n  resolved: ResolvedTheme,\n  attribute: 'class' | 'data-theme' = 'class',\n): void {\n  if (typeof document === 'undefined') return\n\n  const root = document.documentElement\n  if (attribute === 'class') {\n    root.classList.remove('light', 'dark')\n    root.classList.add(resolved)\n  } else {\n    root.setAttribute(attribute, resolved)\n  }\n  root.style.colorScheme = resolved\n}\n","import * as React from 'react'\nimport {\n  createTheme,\n  createLocalStorageAdapter,\n  createMediaQueryAdapter,\n  applyThemeToDOM,\n  type ThemeMode,\n  type ResolvedTheme,\n  type ThemeConfig,\n  type ThemeAPI,\n} from '@refraction-ui/theme'\n\nexport interface ThemeContextValue {\n  mode: ThemeMode\n  resolved: ResolvedTheme\n  setMode: (mode: ThemeMode) => void\n}\n\nconst ThemeContext = React.createContext<ThemeContextValue | null>(null)\n\nexport interface ThemeProviderProps extends ThemeConfig {\n  children: React.ReactNode\n}\n\nexport function ThemeProvider({\n  children,\n  defaultMode = 'system',\n  storageKey = 'rfr-theme',\n  attribute = 'class',\n}: ThemeProviderProps) {\n  const themeRef = React.useRef<ThemeAPI | null>(null)\n\n  // Initialize theme machine once (client-side only for adapters)\n  if (!themeRef.current) {\n    const isBrowser = typeof window !== 'undefined'\n    themeRef.current = createTheme(\n      { defaultMode, storageKey, attribute },\n      isBrowser ? createLocalStorageAdapter() : undefined,\n      isBrowser ? createMediaQueryAdapter() : undefined,\n    )\n  }\n\n  const [state, setState] = React.useState(() => themeRef.current!.getState())\n\n  React.useEffect(() => {\n    const theme = themeRef.current!\n    // Apply initial theme to DOM\n    applyThemeToDOM(theme.getState().resolved, attribute)\n\n    // Subscribe to changes\n    const unsub = theme.subscribe((newState) => {\n      setState(newState)\n      applyThemeToDOM(newState.resolved, attribute)\n    })\n\n    return () => {\n      unsub()\n      theme.destroy()\n    }\n  }, [attribute])\n\n  const contextValue = React.useMemo<ThemeContextValue>(\n    () => ({\n      mode: state.mode,\n      resolved: state.resolved,\n      setMode: (mode: ThemeMode) => themeRef.current?.setMode(mode),\n    }),\n    [state.mode, state.resolved],\n  )\n\n  return React.createElement(ThemeContext.Provider, { value: contextValue }, children)\n}\n\nexport function useTheme(): ThemeContextValue {\n  const context = React.useContext(ThemeContext)\n  if (!context) {\n    throw new Error('useTheme must be used within a <ThemeProvider>')\n  }\n  return context\n}\n","import * as React from 'react'\nimport { useTheme } from './theme-provider.js'\nimport type { ThemeMode } from '@refraction-ui/theme'\n\nconst modes: { value: ThemeMode; label: string; icon: string }[] = [\n  { value: 'light', label: 'Light', icon: 'sun' },\n  { value: 'dark', label: 'Dark', icon: 'moon' },\n  { value: 'system', label: 'System', icon: 'monitor' },\n]\n\n// Inline SVG icons — no external icon library dependency\nconst icons: Record<string, React.ReactNode> = {\n  sun: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('circle', { cx: 12, cy: 12, r: 5 }),\n    React.createElement('path', { d: 'M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42' }),\n  ),\n  moon: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('path', { d: 'M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z' }),\n  ),\n  monitor: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('rect', { x: 2, y: 3, width: 20, height: 14, rx: 2, ry: 2 }),\n    React.createElement('line', { x1: 8, y1: 21, x2: 16, y2: 21 }),\n    React.createElement('line', { x1: 12, y1: 17, x2: 12, y2: 21 }),\n  ),\n}\n\nexport interface ThemeToggleProps {\n  className?: string\n  /** 'dropdown' shows a menu, 'segmented' shows inline buttons */\n  variant?: 'dropdown' | 'segmented'\n}\n\nexport function ThemeToggle({ className, variant = 'segmented' }: ThemeToggleProps) {\n  const { mode, setMode } = useTheme()\n\n  if (variant === 'segmented') {\n    return React.createElement('div', {\n      className: `inline-flex items-center gap-1 rounded-lg border p-1 ${className ?? ''}`,\n      role: 'radiogroup',\n      'aria-label': 'Theme',\n    },\n      modes.map(({ value, label, icon }) =>\n        React.createElement('button', {\n          key: value,\n          type: 'button',\n          role: 'radio',\n          'aria-checked': mode === value,\n          'aria-label': label,\n          className: `inline-flex items-center justify-center rounded-md p-1.5 text-sm transition-colors ${\n            mode === value\n              ? 'bg-accent text-accent-foreground'\n              : 'text-muted-foreground hover:bg-muted'\n          }`,\n          onClick: () => setMode(value),\n        }, icons[icon]),\n      ),\n    )\n  }\n\n  // Dropdown variant — simplified, no external dropdown dependency\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    const handler = (e: MouseEvent) => {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    document.addEventListener('mousedown', handler)\n    return () => document.removeEventListener('mousedown', handler)\n  }, [open])\n\n  const currentIcon = modes.find((m) => m.value === mode)?.icon ?? 'monitor'\n\n  return React.createElement('div', { ref, className: `relative ${className ?? ''}` },\n    React.createElement('button', {\n      type: 'button',\n      'aria-label': 'Toggle theme',\n      'aria-expanded': open,\n      className: 'inline-flex items-center justify-center rounded-md p-2 text-sm transition-colors hover:bg-muted',\n      onClick: () => setOpen(!open),\n    }, icons[currentIcon]),\n    open && React.createElement('div', {\n      className: 'absolute right-0 top-full mt-1 z-50 min-w-[8rem] rounded-md border bg-popover p-1 shadow-md',\n      role: 'menu',\n    },\n      modes.map(({ value, label, icon }) =>\n        React.createElement('button', {\n          key: value,\n          type: 'button',\n          role: 'menuitem',\n          className: `flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-sm transition-colors hover:bg-accent ${\n            mode === value ? 'bg-accent' : ''\n          }`,\n          onClick: () => { setMode(value); setOpen(false) },\n        }, icons[icon], label),\n      ),\n    ),\n  )\n}\n","import * as React from 'react'\nimport { getThemeScript } from '@refraction-ui/theme'\n\nexport interface ThemeScriptProps {\n  storageKey?: string\n  attribute?: 'class' | 'data-theme'\n}\n\n/**\n * Renders an inline <script> that prevents theme flash on SSR pages.\n * Place this in the <head> of your document (in Next.js layout.tsx, Remix root, etc.)\n */\nexport function ThemeScript({\n  storageKey = 'rfr-theme',\n  attribute = 'class',\n}: ThemeScriptProps) {\n  return React.createElement('script', {\n    dangerouslySetInnerHTML: {\n      __html: getThemeScript(storageKey, attribute),\n    },\n  })\n}\n"]}
+{"version":3,"sources":["../../theme/src/theme-machine.ts","../../theme/src/theme-script.ts","../../theme/src/dom-adapters.ts","../../shared/src/dev-feedback.ts","../../react-theme/src/theme-provider.tsx","../../react-theme/src/theme-toggle.tsx","../../react-theme/src/theme-script-component.tsx"],"names":["React","React2","React3"],"mappings":"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","file":"theme.cjs","sourcesContent":["/**\n * Headless theme state machine — pure TypeScript, zero DOM dependencies.\n * Manages light/dark/system mode with system preference tracking.\n */\n\nexport type ThemeMode = 'light' | 'dark' | 'system'\nexport type ResolvedTheme = 'light' | 'dark'\n\nexport interface ThemeState {\n  /** User's chosen mode */\n  mode: ThemeMode\n  /** Resolved theme after system preference detection */\n  resolved: ResolvedTheme\n}\n\nexport interface ThemeConfig {\n  /** Initial mode. Default: 'system' */\n  defaultMode?: ThemeMode\n  /** localStorage key. Default: 'rfr-theme' */\n  storageKey?: string\n  /** HTML attribute to set. Default: 'class' */\n  attribute?: 'class' | 'data-theme'\n}\n\nexport interface StorageAdapter {\n  get(key: string): string | null\n  set(key: string, value: string): void\n}\n\nexport interface MediaQueryAdapter {\n  matches(query: string): boolean\n  subscribe(query: string, callback: (matches: boolean) => void): () => void\n}\n\nexport interface ThemeAPI {\n  /** Get current state */\n  getState(): ThemeState\n  /** Set mode (light/dark/system) */\n  setMode(mode: ThemeMode): void\n  /** Subscribe to state changes */\n  subscribe(fn: (state: ThemeState) => void): () => void\n  /** Clean up subscriptions */\n  destroy(): void\n}\n\nfunction resolveTheme(mode: ThemeMode, systemPrefersDark: boolean): ResolvedTheme {\n  if (mode === 'system') {\n    return systemPrefersDark ? 'dark' : 'light'\n  }\n  return mode\n}\n\nexport function createTheme(\n  config: ThemeConfig = {},\n  storage?: StorageAdapter,\n  mediaQuery?: MediaQueryAdapter,\n): ThemeAPI {\n  const {\n    defaultMode = 'system',\n    storageKey = 'rfr-theme',\n  } = config\n\n  const listeners = new Set<(state: ThemeState) => void>()\n  let cleanupMediaQuery: (() => void) | null = null\n\n  // Read persisted mode or use default\n  const persisted = storage?.get(storageKey) as ThemeMode | null\n  let mode: ThemeMode = persisted && ['light', 'dark', 'system'].includes(persisted)\n    ? persisted\n    : defaultMode\n\n  // Detect system preference\n  let systemPrefersDark = mediaQuery?.matches('(prefers-color-scheme: dark)') ?? false\n\n  let state: ThemeState = {\n    mode,\n    resolved: resolveTheme(mode, systemPrefersDark),\n  }\n\n  function notify() {\n    for (const fn of listeners) {\n      fn(state)\n    }\n  }\n\n  function updateState(newMode: ThemeMode) {\n    mode = newMode\n    state = { mode, resolved: resolveTheme(mode, systemPrefersDark) }\n    storage?.set(storageKey, mode)\n    notify()\n  }\n\n  // Listen for system preference changes\n  if (mediaQuery) {\n    cleanupMediaQuery = mediaQuery.subscribe(\n      '(prefers-color-scheme: dark)',\n      (matches) => {\n        systemPrefersDark = matches\n        if (mode === 'system') {\n          state = { mode, resolved: resolveTheme(mode, systemPrefersDark) }\n          notify()\n        }\n      },\n    )\n  }\n\n  return {\n    getState() {\n      return state\n    },\n\n    setMode(newMode: ThemeMode) {\n      if (newMode !== mode) {\n        updateState(newMode)\n      }\n    },\n\n    subscribe(fn: (state: ThemeState) => void) {\n      listeners.add(fn)\n      return () => {\n        listeners.delete(fn)\n      }\n    },\n\n    destroy() {\n      listeners.clear()\n      cleanupMediaQuery?.()\n    },\n  }\n}\n","/**\n * Inline script for preventing theme flash on page load.\n * Inject this as a <script> tag in the <head> before any CSS.\n * Works with any framework (React, Angular, Astro, plain HTML).\n */\n\nexport function getThemeScript(\n  storageKey = 'rfr-theme',\n  attribute: 'class' | 'data-theme' = 'class',\n): string {\n  // This string is injected as innerHTML of a <script> tag.\n  // It runs before any CSS/JS loads, preventing flash of wrong theme.\n  return `(function(){try{var m=localStorage.getItem('${storageKey}');var s=window.matchMedia('(prefers-color-scheme:dark)').matches;var t=m==='dark'||(m!=='light'&&s)?'dark':'light';var d=document.documentElement;${\n    attribute === 'class'\n      ? \"d.classList.remove('light','dark');d.classList.add(t);\"\n      : `d.setAttribute('${attribute}',t);`\n  }d.style.colorScheme=t;}catch(e){}})()`\n}\n","/**\n * Browser DOM adapters for the theme machine.\n * These bridge the headless core to browser APIs.\n */\n\nimport type { StorageAdapter, MediaQueryAdapter, ResolvedTheme } from './theme-machine.js'\n\n/** localStorage adapter */\nexport function createLocalStorageAdapter(): StorageAdapter {\n  return {\n    get(key) {\n      try {\n        return localStorage.getItem(key)\n      } catch {\n        return null\n      }\n    },\n    set(key, value) {\n      try {\n        localStorage.setItem(key, value)\n      } catch {\n        // localStorage unavailable (SSR, incognito quota exceeded, etc.)\n      }\n    },\n  }\n}\n\n/** matchMedia adapter */\nexport function createMediaQueryAdapter(): MediaQueryAdapter {\n  return {\n    matches(query) {\n      if (typeof window === 'undefined') return false\n      return window.matchMedia(query).matches\n    },\n    subscribe(query, callback) {\n      if (typeof window === 'undefined') return () => {}\n      const mql = window.matchMedia(query)\n      const handler = (e: MediaQueryListEvent) => callback(e.matches)\n      mql.addEventListener('change', handler)\n      return () => mql.removeEventListener('change', handler)\n    },\n  }\n}\n\n/** Apply resolved theme to the document */\nexport function applyThemeToDOM(\n  resolved: ResolvedTheme,\n  attribute: 'class' | 'data-theme' = 'class',\n): void {\n  if (typeof document === 'undefined') return\n\n  const root = document.documentElement\n  if (attribute === 'class') {\n    root.classList.remove('light', 'dark')\n    root.classList.add(resolved)\n  } else {\n    root.setAttribute(attribute, resolved)\n  }\n  root.style.colorScheme = resolved\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","import * as React from 'react'\nimport {\n  createTheme,\n  createLocalStorageAdapter,\n  createMediaQueryAdapter,\n  applyThemeToDOM,\n  type ThemeMode,\n  type ResolvedTheme,\n  type ThemeConfig,\n  type ThemeAPI,\n} from '@refraction-ui/theme'\nimport { devWarn } from '@refraction-ui/shared'\n\nexport interface ThemeContextValue {\n  mode: ThemeMode\n  resolved: ResolvedTheme\n  setMode: (mode: ThemeMode) => void\n}\n\nconst ThemeContext = React.createContext<ThemeContextValue | null>(null)\n\nexport interface ThemeProviderProps extends ThemeConfig {\n  children: React.ReactNode\n}\n\nexport function ThemeProvider({\n  children,\n  defaultMode = 'system',\n  storageKey = 'rfr-theme',\n  attribute = 'class',\n}: ThemeProviderProps) {\n  const themeRef = React.useRef<ThemeAPI | null>(null)\n\n  // Initialize theme machine once (client-side only for adapters)\n  if (!themeRef.current) {\n    const isBrowser = typeof window !== 'undefined'\n    themeRef.current = createTheme(\n      { defaultMode, storageKey, attribute },\n      isBrowser ? createLocalStorageAdapter() : undefined,\n      isBrowser ? createMediaQueryAdapter() : undefined,\n    )\n  }\n\n  const [state, setState] = React.useState(() => themeRef.current!.getState())\n\n  React.useEffect(() => {\n    const theme = themeRef.current!\n    // Apply initial theme to DOM\n    applyThemeToDOM(theme.getState().resolved, attribute)\n\n    // Subscribe to changes\n    const unsub = theme.subscribe((newState) => {\n      setState(newState)\n      applyThemeToDOM(newState.resolved, attribute)\n    })\n\n    return () => {\n      unsub()\n      theme.destroy()\n    }\n  }, [attribute])\n\n  const contextValue = React.useMemo<ThemeContextValue>(\n    () => ({\n      mode: state.mode,\n      resolved: state.resolved,\n      setMode: (mode: ThemeMode) => themeRef.current?.setMode(mode),\n    }),\n    [state.mode, state.resolved],\n  )\n\n  return React.createElement(ThemeContext.Provider, { value: contextValue }, children)\n}\n\nexport function useTheme(): ThemeContextValue {\n  const context = React.useContext(ThemeContext)\n  if (!context) {\n    devWarn(\n      'react-theme/use-theme-outside-provider',\n      'useTheme() was called outside a <ThemeProvider>. Wrap your app (or the consuming subtree) in <ThemeProvider> so the theme context is available.',\n    )\n    throw new Error('useTheme must be used within a <ThemeProvider>')\n  }\n  return context\n}\n","import * as React from 'react'\nimport { useTheme } from './theme-provider.js'\nimport type { ThemeMode } from '@refraction-ui/theme'\n\nconst modes: { value: ThemeMode; label: string; icon: string }[] = [\n  { value: 'light', label: 'Light', icon: 'sun' },\n  { value: 'dark', label: 'Dark', icon: 'moon' },\n  { value: 'system', label: 'System', icon: 'monitor' },\n]\n\n// Inline SVG icons — no external icon library dependency\nconst icons: Record<string, React.ReactNode> = {\n  sun: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('circle', { cx: 12, cy: 12, r: 5 }),\n    React.createElement('path', { d: 'M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42' }),\n  ),\n  moon: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('path', { d: 'M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z' }),\n  ),\n  monitor: React.createElement('svg', {\n    xmlns: 'http://www.w3.org/2000/svg', width: 16, height: 16, viewBox: '0 0 24 24',\n    fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  },\n    React.createElement('rect', { x: 2, y: 3, width: 20, height: 14, rx: 2, ry: 2 }),\n    React.createElement('line', { x1: 8, y1: 21, x2: 16, y2: 21 }),\n    React.createElement('line', { x1: 12, y1: 17, x2: 12, y2: 21 }),\n  ),\n}\n\nexport interface ThemeToggleProps {\n  className?: string\n  /** 'dropdown' shows a menu, 'segmented' shows inline buttons */\n  variant?: 'dropdown' | 'segmented'\n}\n\nexport function ThemeToggle({ className, variant = 'segmented' }: ThemeToggleProps) {\n  const { mode, setMode } = useTheme()\n\n  if (variant === 'segmented') {\n    return React.createElement('div', {\n      className: `inline-flex items-center gap-1 rounded-lg border p-1 ${className ?? ''}`,\n      role: 'radiogroup',\n      'aria-label': 'Theme',\n    },\n      modes.map(({ value, label, icon }) =>\n        React.createElement('button', {\n          key: value,\n          type: 'button',\n          role: 'radio',\n          'aria-checked': mode === value,\n          'aria-label': label,\n          className: `inline-flex items-center justify-center rounded-md p-1.5 text-sm transition-colors ${\n            mode === value\n              ? 'bg-accent text-accent-foreground'\n              : 'text-muted-foreground hover:bg-muted'\n          }`,\n          onClick: () => setMode(value),\n        }, icons[icon]),\n      ),\n    )\n  }\n\n  // Dropdown variant — simplified, no external dropdown dependency\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    const handler = (e: MouseEvent) => {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    document.addEventListener('mousedown', handler)\n    return () => document.removeEventListener('mousedown', handler)\n  }, [open])\n\n  const currentIcon = modes.find((m) => m.value === mode)?.icon ?? 'monitor'\n\n  return React.createElement('div', { ref, className: `relative ${className ?? ''}` },\n    React.createElement('button', {\n      type: 'button',\n      'aria-label': 'Toggle theme',\n      'aria-expanded': open,\n      className: 'inline-flex items-center justify-center rounded-md p-2 text-sm transition-colors hover:bg-muted',\n      onClick: () => setOpen(!open),\n    }, icons[currentIcon]),\n    open && React.createElement('div', {\n      className: 'absolute right-0 top-full mt-1 z-50 min-w-[8rem] rounded-md border bg-popover p-1 shadow-md',\n      role: 'menu',\n    },\n      modes.map(({ value, label, icon }) =>\n        React.createElement('button', {\n          key: value,\n          type: 'button',\n          role: 'menuitem',\n          className: `flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-sm transition-colors hover:bg-accent ${\n            mode === value ? 'bg-accent' : ''\n          }`,\n          onClick: () => { setMode(value); setOpen(false) },\n        }, icons[icon], label),\n      ),\n    ),\n  )\n}\n","import * as React from 'react'\nimport { getThemeScript } from '@refraction-ui/theme'\n\nexport interface ThemeScriptProps {\n  storageKey?: string\n  attribute?: 'class' | 'data-theme'\n}\n\n/**\n * Renders an inline <script> that prevents theme flash on SSR pages.\n * Place this in the <head> of your document (in Next.js layout.tsx, Remix root, etc.)\n */\nexport function ThemeScript({\n  storageKey = 'rfr-theme',\n  attribute = 'class',\n}: ThemeScriptProps) {\n  return React.createElement('script', {\n    dangerouslySetInnerHTML: {\n      __html: getThemeScript(storageKey, attribute),\n    },\n  })\n}\n"]}

package/dist/theme.js

@@ -1,7 +1,6 @@
+import { devWarn } from './chunk-O4453CBF.js';
 import * as React2 from 'react';
 
-// ../react-theme/dist/index.js
-
 // ../theme/dist/index.js
 function resolveTheme(mode, systemPrefersDark) {
   if (mode === "system") {
@@ -158,6 +157,10 @@ function ThemeProvider({
 function useTheme() {
   const context = React2.useContext(ThemeContext);
   if (!context) {
+    devWarn(
+      "react-theme/use-theme-outside-provider",
+      "useTheme() was called outside a <ThemeProvider>. Wrap your app (or the consuming subtree) in <ThemeProvider> so the theme context is available."
+    );
     throw new Error("useTheme must be used within a <ThemeProvider>");
   }
   return context;