@coinlist-co/react 0.5.0 → 0.6.0

package/dist/client/index.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { A as AuthorizationCode, C as CodeVerifier, a as Config, O as OAuthAccessToken, b as Offer, P as PaginationParams, c as PaginatedResponse, d as OfferId, e as OfferDetail, f as Participation, g as ParticipationsPaginationParams, h as ParticipationId, i as CreateParticipationParams, j as OfferOptionId, R as Requirement, k as RequirementStatusInfo, l as RequirementType, m as RequirementStatusValue } from '../requirement-BEO42QOr.cjs';
+import { A as AuthorizationCode, C as CodeVerifier, a as Config, O as OAuthAccessToken, b as Offer, P as PaginationParams, c as PaginatedResponse, d as OfferId, e as OfferDetail, f as Participation, g as ParticipationsPaginationParams, h as ParticipationId, i as CreateParticipationParams, j as OfferOptionId, R as Requirement, k as RequirementStatusInfo, l as RequirementType, m as RequirementStatusValue } from '../requirement-Dk6nYN1c.cjs';
 
 type AuthState = 'unknown' | 'logged-in' | 'logged-out';
 /** Discriminated error reasons from {@link CoinListClient.completeOAuth}. */
@@ -170,10 +170,40 @@ type CoinListProviderProps = {
     children: ReactNode;
 };
 /**
- * Provide CoinList (api + config) to the tree. Initialize once at app root with your config.
+ * Provide CoinList (api + config) to the tree WITHOUT any styling. Renders only the
+ * React context: no DOM, no <style>, no .clco-sdk-root. Safe to mount app-wide:
+ * it has zero visual impact on the host's own pages.
+ *
+ * Use this when you need useCoinList() available app-wide. Wrap SDK visual components
+ * in {@link CoinListStyleScope} separately. For dropping in a single widget, use the
+ * all-in-one {@link CoinListProvider}.
+ */
+declare function CoinListContextProvider({ config, children, }: CoinListProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * All-in-one provider: the React context plus the SDK styling wrapper. Convenience for
+ * dropping in a single widget. Composes {@link CoinListContextProvider} and
+ * {@link CoinListStyleScope}.
+ *
+ * Caution: this applies SDK styling (.clco-sdk-root) to everything below it. If you need
+ * context app-wide without styling the host's pages, mount {@link CoinListContextProvider}
+ * at the root and wrap only SDK visual components in {@link CoinListStyleScope}.
  */
 declare function CoinListProvider({ config, children }: CoinListProviderProps): react_jsx_runtime.JSX.Element;
 
+type CoinListStyleScopeProps = {
+    children: ReactNode;
+};
+/**
+ * Render the SDK styling wrapper: the Inter font links and the .clco-sdk-root div
+ * with the self-contained, scoped <style> injection. Mount this around SDK visual
+ * components only. Keep it off the host's own pages to avoid styling them.
+ *
+ * This component self-injects all SDK styles via an inline <style> tag so consumers
+ * do not need to import any CSS files or configure their bundler. Styles are fully
+ * scoped to .clco-sdk-root and do not leak to the host page.
+ */
+declare function CoinListStyleScope({ children }: CoinListStyleScopeProps): react_jsx_runtime.JSX.Element;
+
 interface CoinListSignInCardProps {
     state?: 'idle' | 'error';
     /**
@@ -535,4 +565,4 @@ interface UseParticipationsResult {
  */
 declare function useParticipations(offerId?: OfferId, options?: UseParticipationsOptions): UseParticipationsResult;
 
-export { type AuthState, ChecklistStatus, type ClientConfig, type CoinListClient, CoinListClientInitializationError, CoinListContext, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInCard, type CoinListSignInCardProps, type CompleteOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGrid, type OffersGridProps, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklist, type RequirementsChecklistProps, type RequirementsData, type UseCoinListResult, type UseCompleteOAuthOptions, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersOptions, type UseOffersResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsOptions, type UseRequirementsResult, createCoinListClient, useCoinList, useCompleteOAuth, useOfferDetails, useOffers, useParticipations, useRequirements };
+export { type AuthState, ChecklistStatus, type ClientConfig, type CoinListClient, CoinListClientInitializationError, CoinListContext, CoinListContextProvider, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInCard, type CoinListSignInCardProps, CoinListStyleScope, type CoinListStyleScopeProps, type CompleteOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGrid, type OffersGridProps, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklist, type RequirementsChecklistProps, type RequirementsData, type UseCoinListResult, type UseCompleteOAuthOptions, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersOptions, type UseOffersResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsOptions, type UseRequirementsResult, createCoinListClient, useCoinList, useCompleteOAuth, useOfferDetails, useOffers, useParticipations, useRequirements };

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { A as AuthorizationCode, C as CodeVerifier, a as Config, O as OAuthAccessToken, b as Offer, P as PaginationParams, c as PaginatedResponse, d as OfferId, e as OfferDetail, f as Participation, g as ParticipationsPaginationParams, h as ParticipationId, i as CreateParticipationParams, j as OfferOptionId, R as Requirement, k as RequirementStatusInfo, l as RequirementType, m as RequirementStatusValue } from '../requirement-BEO42QOr.js';
+import { A as AuthorizationCode, C as CodeVerifier, a as Config, O as OAuthAccessToken, b as Offer, P as PaginationParams, c as PaginatedResponse, d as OfferId, e as OfferDetail, f as Participation, g as ParticipationsPaginationParams, h as ParticipationId, i as CreateParticipationParams, j as OfferOptionId, R as Requirement, k as RequirementStatusInfo, l as RequirementType, m as RequirementStatusValue } from '../requirement-Dk6nYN1c.js';
 
 type AuthState = 'unknown' | 'logged-in' | 'logged-out';
 /** Discriminated error reasons from {@link CoinListClient.completeOAuth}. */
@@ -170,10 +170,40 @@ type CoinListProviderProps = {
     children: ReactNode;
 };
 /**
- * Provide CoinList (api + config) to the tree. Initialize once at app root with your config.
+ * Provide CoinList (api + config) to the tree WITHOUT any styling. Renders only the
+ * React context: no DOM, no <style>, no .clco-sdk-root. Safe to mount app-wide:
+ * it has zero visual impact on the host's own pages.
+ *
+ * Use this when you need useCoinList() available app-wide. Wrap SDK visual components
+ * in {@link CoinListStyleScope} separately. For dropping in a single widget, use the
+ * all-in-one {@link CoinListProvider}.
+ */
+declare function CoinListContextProvider({ config, children, }: CoinListProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * All-in-one provider: the React context plus the SDK styling wrapper. Convenience for
+ * dropping in a single widget. Composes {@link CoinListContextProvider} and
+ * {@link CoinListStyleScope}.
+ *
+ * Caution: this applies SDK styling (.clco-sdk-root) to everything below it. If you need
+ * context app-wide without styling the host's pages, mount {@link CoinListContextProvider}
+ * at the root and wrap only SDK visual components in {@link CoinListStyleScope}.
  */
 declare function CoinListProvider({ config, children }: CoinListProviderProps): react_jsx_runtime.JSX.Element;
 
+type CoinListStyleScopeProps = {
+    children: ReactNode;
+};
+/**
+ * Render the SDK styling wrapper: the Inter font links and the .clco-sdk-root div
+ * with the self-contained, scoped <style> injection. Mount this around SDK visual
+ * components only. Keep it off the host's own pages to avoid styling them.
+ *
+ * This component self-injects all SDK styles via an inline <style> tag so consumers
+ * do not need to import any CSS files or configure their bundler. Styles are fully
+ * scoped to .clco-sdk-root and do not leak to the host page.
+ */
+declare function CoinListStyleScope({ children }: CoinListStyleScopeProps): react_jsx_runtime.JSX.Element;
+
 interface CoinListSignInCardProps {
     state?: 'idle' | 'error';
     /**
@@ -535,4 +565,4 @@ interface UseParticipationsResult {
  */
 declare function useParticipations(offerId?: OfferId, options?: UseParticipationsOptions): UseParticipationsResult;
 
-export { type AuthState, ChecklistStatus, type ClientConfig, type CoinListClient, CoinListClientInitializationError, CoinListContext, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInCard, type CoinListSignInCardProps, type CompleteOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGrid, type OffersGridProps, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklist, type RequirementsChecklistProps, type RequirementsData, type UseCoinListResult, type UseCompleteOAuthOptions, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersOptions, type UseOffersResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsOptions, type UseRequirementsResult, createCoinListClient, useCoinList, useCompleteOAuth, useOfferDetails, useOffers, useParticipations, useRequirements };
+export { type AuthState, ChecklistStatus, type ClientConfig, type CoinListClient, CoinListClientInitializationError, CoinListContext, CoinListContextProvider, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInCard, type CoinListSignInCardProps, CoinListStyleScope, type CoinListStyleScopeProps, type CompleteOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGrid, type OffersGridProps, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklist, type RequirementsChecklistProps, type RequirementsData, type UseCoinListResult, type UseCompleteOAuthOptions, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersOptions, type UseOffersResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsOptions, type UseRequirementsResult, createCoinListClient, useCoinList, useCompleteOAuth, useOfferDetails, useOffers, useParticipations, useRequirements };