@refraction-ui/react 0.9.1 → 0.9.2

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

@@ -259,6 +259,16 @@ interface Analytics {
  */
 declare function createAnalytics(config: AnalyticsConfig): Analytics;
 
+/**
+ * The noop collector returned when `enabled: false`.
+ *
+ * Every method is an empty function so calls are free and the surrounding
+ * vendor/sink code can be tree-shaken out of a production bundle when
+ * analytics is compiled off. Kept in its own module so bundlers can drop the
+ * live collector entirely on the `enabled:false` path.
+ */
+declare function createNoopAnalytics(): Analytics;
+
 /** Create the built-in Segment-spec HTTP sink. */
 declare function createHttpSink(options: HttpSinkOptions): AnalyticsSink;
 
@@ -445,4 +455,4 @@ declare const UUID_V4_RE: RegExp;
 /** True when `value` is a well-formed v4 UUID. */
 declare function isUuidV4(value: unknown): value is string;
 
-export { type Analytics, type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventType, type AnalyticsProperties, type AnalyticsSink, type AnalyticsStorage, type CallOptions, type ConsentAPI, type ConsentConfig, type ConsoleSinkOptions, type CreateMockSinkOptions, DEFAULT_SESSION_TIMEOUT_MS, type HttpSinkOptions, type IdentityConfig, type MockSink, PII_DENY_LIST, PII_EXACT_KEYS, REDACTED, type Redactor, SCHEMA_VERSION, type SessionAPI, type SessionConfig, type SinkDeliverContext, type SinkInitContext, UUID_V4_RE, campaignFingerprint, createAnalytics, createConsent, createConsoleSink, createCookieAdapter, createHttpSink, createIdentity, createLocalStorageAdapter, createMemoryStorage, createMockSink, createRedactor, createSession, isUuidV4, resolveStorage, uuidv4 };
+export { type Analytics, type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventType, type AnalyticsProperties, type AnalyticsSink, type AnalyticsStorage, type CallOptions, type ConsentAPI, type ConsentConfig, type ConsoleSinkOptions, type CreateMockSinkOptions, DEFAULT_SESSION_TIMEOUT_MS, type HttpSinkOptions, type IdentityConfig, type MockSink, PII_DENY_LIST, PII_EXACT_KEYS, REDACTED, type Redactor, SCHEMA_VERSION, type SessionAPI, type SessionConfig, type SinkDeliverContext, type SinkInitContext, UUID_V4_RE, campaignFingerprint, createAnalytics, createConsent, createConsoleSink, createCookieAdapter, createHttpSink, createIdentity, createLocalStorageAdapter, createMemoryStorage, createMockSink, createNoopAnalytics, createRedactor, createSession, isUuidV4, resolveStorage, uuidv4 };

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

@@ -259,6 +259,16 @@ interface Analytics {
  */
 declare function createAnalytics(config: AnalyticsConfig): Analytics;
 
+/**
+ * The noop collector returned when `enabled: false`.
+ *
+ * Every method is an empty function so calls are free and the surrounding
+ * vendor/sink code can be tree-shaken out of a production bundle when
+ * analytics is compiled off. Kept in its own module so bundlers can drop the
+ * live collector entirely on the `enabled:false` path.
+ */
+declare function createNoopAnalytics(): Analytics;
+
 /** Create the built-in Segment-spec HTTP sink. */
 declare function createHttpSink(options: HttpSinkOptions): AnalyticsSink;
 
@@ -445,4 +455,4 @@ declare const UUID_V4_RE: RegExp;
 /** True when `value` is a well-formed v4 UUID. */
 declare function isUuidV4(value: unknown): value is string;
 
-export { type Analytics, type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventType, type AnalyticsProperties, type AnalyticsSink, type AnalyticsStorage, type CallOptions, type ConsentAPI, type ConsentConfig, type ConsoleSinkOptions, type CreateMockSinkOptions, DEFAULT_SESSION_TIMEOUT_MS, type HttpSinkOptions, type IdentityConfig, type MockSink, PII_DENY_LIST, PII_EXACT_KEYS, REDACTED, type Redactor, SCHEMA_VERSION, type SessionAPI, type SessionConfig, type SinkDeliverContext, type SinkInitContext, UUID_V4_RE, campaignFingerprint, createAnalytics, createConsent, createConsoleSink, createCookieAdapter, createHttpSink, createIdentity, createLocalStorageAdapter, createMemoryStorage, createMockSink, createRedactor, createSession, isUuidV4, resolveStorage, uuidv4 };
+export { type Analytics, type AnalyticsConfig, type AnalyticsContext, type AnalyticsEvent, type AnalyticsEventType, type AnalyticsProperties, type AnalyticsSink, type AnalyticsStorage, type CallOptions, type ConsentAPI, type ConsentConfig, type ConsoleSinkOptions, type CreateMockSinkOptions, DEFAULT_SESSION_TIMEOUT_MS, type HttpSinkOptions, type IdentityConfig, type MockSink, PII_DENY_LIST, PII_EXACT_KEYS, REDACTED, type Redactor, SCHEMA_VERSION, type SessionAPI, type SessionConfig, type SinkDeliverContext, type SinkInitContext, UUID_V4_RE, campaignFingerprint, createAnalytics, createConsent, createConsoleSink, createCookieAdapter, createHttpSink, createIdentity, createLocalStorageAdapter, createMemoryStorage, createMockSink, createNoopAnalytics, createRedactor, createSession, isUuidV4, resolveStorage, uuidv4 };

package/dist/internal/react-analytics/index.d.cts

@@ -32,7 +32,10 @@ interface UseAnalyticsOptions {
  * useAnalytics — access the `Analytics` instance from context.
  *
  * Pass `{ scope }` to receive a `with(...)` child whose context is merged
- * into every event. Must be used within an `<AnalyticsProvider>`.
+ * into every event. If called outside an `<AnalyticsProvider>` it does NOT
+ * throw: it returns a shared no-op `Analytics` (a dev-only warn-once hint is
+ * emitted). Instrumenting a component with analytics must never crash the
+ * host (incl. in tests).
  */
 declare function useAnalytics(options?: UseAnalyticsOptions): Analytics;
 /**

package/dist/internal/react-analytics/index.d.ts

@@ -32,7 +32,10 @@ interface UseAnalyticsOptions {
  * useAnalytics — access the `Analytics` instance from context.
  *
  * Pass `{ scope }` to receive a `with(...)` child whose context is merged
- * into every event. Must be used within an `<AnalyticsProvider>`.
+ * into every event. If called outside an `<AnalyticsProvider>` it does NOT
+ * throw: it returns a shared no-op `Analytics` (a dev-only warn-once hint is
+ * emitted). Instrumenting a component with analytics must never crash the
+ * host (incl. in tests).
  */
 declare function useAnalytics(options?: UseAnalyticsOptions): Analytics;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refraction-ui/react",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "All Refraction UI React components in one package — headless, accessible, zero-dependency",
   "type": "module",
   "main": "./dist/index.js",