@kerne/react 1.2.0 → 1.3.0

package/dist/{i18n-CXEhPK58.d.cts → fr-E5mmylSH.d.cts}

@@ -201,7 +201,9 @@ interface KerneLocalization {
         switchConfirmButton: string;
         switchConfirmDismiss: string;
         noPlans: string;
+        /** A plan with no price under the selected PriceLabel - which needn't be a billing interval (see PublicPriceLabel). */
         notOnInterval: string;
+        differentCurrency: string;
         loadFailed: string;
         loadingPlan: string;
         loadingPlans: string;
@@ -242,8 +244,61 @@ interface KerneLocalization {
         billedAt: string;
         /** "Save {percent}%" - the label-switch hint. */
         save: string;
-        /** Prefixes a QUOTA entitlement with no ceiling, e.g. "Unlimited projects". */
+        /** The value column for a QUOTA with no ceiling. */
         unlimited: string;
+        /** The value column for an entitlement that carries no figure - a boolean, or a quota with no declared ceiling. */
+        included: string;
+        /** The value column for a boolean the plan does NOT grant. */
+        notIncluded: string;
+        /** Replaces the amount when a plan costs nothing. */
+        free: string;
+        /** Replaces "/ month" beside `free`. */
+        forever: string;
+        /** The call to action on a plan that costs nothing. */
+        startFree: string;
+        /** "{days}-day trial, no card" - under the button that accepts the offer. */
+        trialNote: string;
+        /** Beside an allowance that keeps serving past its included amount, and bills. */
+        thenMetered: string;
+        /** Heading of the popover that explains a metered overage. */
+        meterTitle: string;
+        /** "Rate per {thing}" - the thing being counted, a customer or a slice. */
+        meterRatePer: string;
+        meterShape: string;
+        meterCounted: string;
+        meterResets: string;
+        meterCapped: string;
+        /** "{count} tiers, cheapest {amount}" / "one rate" - how the schedule is read. */
+        meterTiers: string;
+        meterFlat: string;
+        /** Whole quantity at the reached rate, vs each slice at its own. */
+        meterVolume: string;
+        meterGraduated: string;
+        /** "per {slice}" / "per customer", then how a partial block is counted. */
+        meterPerSlice: string;
+        meterPerCustomer: string;
+        /** "every {interval}" - the cadence the allowance actually comes back on. */
+        meterResetsEvery: string;
+        /** "{amount} per {slice}" on an allowance counted once per slice. */
+        perSlice: string;
+        meterRoundedUp: string;
+        meterRoundedDown: string;
+        meterResetsCycle: string;
+        meterResetsNever: string;
+        /** Stands in for the allowance when nothing is included and every unit bills. */
+        metered: string;
+        /** Prefixes a rate that falls as volume grows, e.g. "from $0.10 / GB". */
+        from: string;
+        /** Header of the block where a buyer sizes prepaid volume. */
+        sizeUpFront: string;
+        /** Caption beside it - prepaid steps bill on the plan's own cycle. */
+        billedWithPlan: string;
+        /** "{amount} {unit} included" under a sizing rail left at zero. */
+        includedAmount: string;
+        /** "+{amount} {unit} prepaid" once the rail moves. */
+        prepaidAmount: string;
+        /** Shown under a plan's hairline when it grants nothing the catalogue can list. */
+        nothingListed: string;
         /** "+{count} more" - shown when `maxFeatures` truncates a plan's entitlement list. */
         moreFeatures: string;
         loading: string;
@@ -282,9 +337,86 @@ interface KerneLocalization {
     };
 }
 declare const defaultLocalization: KerneLocalization;
+/**
+ * Shallow-merges each top-level group of `override` onto `base` (the English pack by
+ * default) so a partial override keeps the rest. Pass a full pack (e.g. `fr`) as `base`
+ * to layer a few overrides on top of a whole-language translation instead of English.
+ */
+declare function mergeLocalization(override?: DeepPartial<KerneLocalization>, base?: KerneLocalization): KerneLocalization;
 type DeepPartial<T> = {
     [K in keyof T]?: Partial<T[K]>;
 };
 declare function useLocalization(): KerneLocalization;
 
-export { type DeepPartial as D, type KerneLocalization as K, defaultLocalization as d, useLocalization as u };
+/**
+ * Styling for the prebuilt components.
+ *
+ * A single stylesheet injected once at runtime, rather than a CSS file the
+ * host app has to import: the whole point of these components is that a tenant
+ * drops one in and it works, and "don't forget to import @kerne/react/styles.css"
+ * is exactly the step people forget. It also keeps the package dependency-free -
+ * no CSS-in-JS runtime, no Tailwind assumption about the host build.
+ *
+ * Everything visual resolves from `--kerne-*` custom properties, so a tenant
+ * restyles by setting those anywhere in their own CSS (no `!important` war, no
+ * forking) and `appearance` overrides them per instance.
+ */
+/**
+ * The default palette's raw values, for a host that wants its OWN stylesheet to match Kerne's
+ * rather than reading them off the rendered page - `.dark` is only the tokens dark actually
+ * overrides, not the full set (unset ones inherit `.light`, same as the CSS does).
+ */
+declare const defaultTokens: {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+};
+/**
+ * Per-instance overrides of the same custom properties the stylesheet reads,
+ * applied as inline style so they win over the class defaults without
+ * specificity tricks.
+ */
+interface KerneAppearance {
+    /**
+     * `light` (default), `dark`, or `system` to follow the visitor's OS. Not
+     * defaulted to `system`: a light-only host would silently render a dark form
+     * for half its users.
+     */
+    theme?: 'light' | 'dark' | 'system';
+    /**
+     * The brand colour. Drives the primary button, and - unless overridden below -
+     * its label, its hover, and the accent used for focus rings and links.
+     */
+    primaryColor?: string;
+    /** Label on the primary button. Derived from `primaryColor` when omitted. */
+    primaryTextColor?: string;
+    /** Focus rings and links. Falls back to `primaryColor`. */
+    accentColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    /** Background of error/info panels. */
+    panelColor?: string;
+    /**
+     * The ground the component sits on. Leave unset when embedding (the host's
+     * page shows through); set it when the component owns the viewport, so its
+     * text can never resolve against a background it doesn't know about.
+     */
+    background?: string;
+    /** Opaque ground for the card variant, the account dropdown, a pressed segment. */
+    surfaceColor?: string;
+    /** `card` wraps the screen in a bordered, raised container. Defaults to `none`. */
+    surface?: 'none' | 'card';
+    fontFamily?: string;
+    /** Corner radius on inputs and buttons, e.g. `"0px"` for square. */
+    radius?: string;
+    /** Height of inputs and buttons. Defaults to `"44px"`. */
+    controlHeight?: string;
+}
+
+/**
+ * French pack for the prebuilt components - see `KerneLocalization` for the full shape and
+ * `defaultLocalization` (English) for the reference this was translated from.
+ */
+
+declare const fr: KerneLocalization;
+
+export { type DeepPartial as D, type KerneLocalization as K, type KerneAppearance as a, defaultTokens as b, defaultLocalization as d, fr as f, mergeLocalization as m, useLocalization as u };

package/dist/{i18n-CXEhPK58.d.ts → fr-E5mmylSH.d.ts}

@@ -201,7 +201,9 @@ interface KerneLocalization {
         switchConfirmButton: string;
         switchConfirmDismiss: string;
         noPlans: string;
+        /** A plan with no price under the selected PriceLabel - which needn't be a billing interval (see PublicPriceLabel). */
         notOnInterval: string;
+        differentCurrency: string;
         loadFailed: string;
         loadingPlan: string;
         loadingPlans: string;
@@ -242,8 +244,61 @@ interface KerneLocalization {
         billedAt: string;
         /** "Save {percent}%" - the label-switch hint. */
         save: string;
-        /** Prefixes a QUOTA entitlement with no ceiling, e.g. "Unlimited projects". */
+        /** The value column for a QUOTA with no ceiling. */
         unlimited: string;
+        /** The value column for an entitlement that carries no figure - a boolean, or a quota with no declared ceiling. */
+        included: string;
+        /** The value column for a boolean the plan does NOT grant. */
+        notIncluded: string;
+        /** Replaces the amount when a plan costs nothing. */
+        free: string;
+        /** Replaces "/ month" beside `free`. */
+        forever: string;
+        /** The call to action on a plan that costs nothing. */
+        startFree: string;
+        /** "{days}-day trial, no card" - under the button that accepts the offer. */
+        trialNote: string;
+        /** Beside an allowance that keeps serving past its included amount, and bills. */
+        thenMetered: string;
+        /** Heading of the popover that explains a metered overage. */
+        meterTitle: string;
+        /** "Rate per {thing}" - the thing being counted, a customer or a slice. */
+        meterRatePer: string;
+        meterShape: string;
+        meterCounted: string;
+        meterResets: string;
+        meterCapped: string;
+        /** "{count} tiers, cheapest {amount}" / "one rate" - how the schedule is read. */
+        meterTiers: string;
+        meterFlat: string;
+        /** Whole quantity at the reached rate, vs each slice at its own. */
+        meterVolume: string;
+        meterGraduated: string;
+        /** "per {slice}" / "per customer", then how a partial block is counted. */
+        meterPerSlice: string;
+        meterPerCustomer: string;
+        /** "every {interval}" - the cadence the allowance actually comes back on. */
+        meterResetsEvery: string;
+        /** "{amount} per {slice}" on an allowance counted once per slice. */
+        perSlice: string;
+        meterRoundedUp: string;
+        meterRoundedDown: string;
+        meterResetsCycle: string;
+        meterResetsNever: string;
+        /** Stands in for the allowance when nothing is included and every unit bills. */
+        metered: string;
+        /** Prefixes a rate that falls as volume grows, e.g. "from $0.10 / GB". */
+        from: string;
+        /** Header of the block where a buyer sizes prepaid volume. */
+        sizeUpFront: string;
+        /** Caption beside it - prepaid steps bill on the plan's own cycle. */
+        billedWithPlan: string;
+        /** "{amount} {unit} included" under a sizing rail left at zero. */
+        includedAmount: string;
+        /** "+{amount} {unit} prepaid" once the rail moves. */
+        prepaidAmount: string;
+        /** Shown under a plan's hairline when it grants nothing the catalogue can list. */
+        nothingListed: string;
         /** "+{count} more" - shown when `maxFeatures` truncates a plan's entitlement list. */
         moreFeatures: string;
         loading: string;
@@ -282,9 +337,86 @@ interface KerneLocalization {
     };
 }
 declare const defaultLocalization: KerneLocalization;
+/**
+ * Shallow-merges each top-level group of `override` onto `base` (the English pack by
+ * default) so a partial override keeps the rest. Pass a full pack (e.g. `fr`) as `base`
+ * to layer a few overrides on top of a whole-language translation instead of English.
+ */
+declare function mergeLocalization(override?: DeepPartial<KerneLocalization>, base?: KerneLocalization): KerneLocalization;
 type DeepPartial<T> = {
     [K in keyof T]?: Partial<T[K]>;
 };
 declare function useLocalization(): KerneLocalization;
 
-export { type DeepPartial as D, type KerneLocalization as K, defaultLocalization as d, useLocalization as u };
+/**
+ * Styling for the prebuilt components.
+ *
+ * A single stylesheet injected once at runtime, rather than a CSS file the
+ * host app has to import: the whole point of these components is that a tenant
+ * drops one in and it works, and "don't forget to import @kerne/react/styles.css"
+ * is exactly the step people forget. It also keeps the package dependency-free -
+ * no CSS-in-JS runtime, no Tailwind assumption about the host build.
+ *
+ * Everything visual resolves from `--kerne-*` custom properties, so a tenant
+ * restyles by setting those anywhere in their own CSS (no `!important` war, no
+ * forking) and `appearance` overrides them per instance.
+ */
+/**
+ * The default palette's raw values, for a host that wants its OWN stylesheet to match Kerne's
+ * rather than reading them off the rendered page - `.dark` is only the tokens dark actually
+ * overrides, not the full set (unset ones inherit `.light`, same as the CSS does).
+ */
+declare const defaultTokens: {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+};
+/**
+ * Per-instance overrides of the same custom properties the stylesheet reads,
+ * applied as inline style so they win over the class defaults without
+ * specificity tricks.
+ */
+interface KerneAppearance {
+    /**
+     * `light` (default), `dark`, or `system` to follow the visitor's OS. Not
+     * defaulted to `system`: a light-only host would silently render a dark form
+     * for half its users.
+     */
+    theme?: 'light' | 'dark' | 'system';
+    /**
+     * The brand colour. Drives the primary button, and - unless overridden below -
+     * its label, its hover, and the accent used for focus rings and links.
+     */
+    primaryColor?: string;
+    /** Label on the primary button. Derived from `primaryColor` when omitted. */
+    primaryTextColor?: string;
+    /** Focus rings and links. Falls back to `primaryColor`. */
+    accentColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    /** Background of error/info panels. */
+    panelColor?: string;
+    /**
+     * The ground the component sits on. Leave unset when embedding (the host's
+     * page shows through); set it when the component owns the viewport, so its
+     * text can never resolve against a background it doesn't know about.
+     */
+    background?: string;
+    /** Opaque ground for the card variant, the account dropdown, a pressed segment. */
+    surfaceColor?: string;
+    /** `card` wraps the screen in a bordered, raised container. Defaults to `none`. */
+    surface?: 'none' | 'card';
+    fontFamily?: string;
+    /** Corner radius on inputs and buttons, e.g. `"0px"` for square. */
+    radius?: string;
+    /** Height of inputs and buttons. Defaults to `"44px"`. */
+    controlHeight?: string;
+}
+
+/**
+ * French pack for the prebuilt components - see `KerneLocalization` for the full shape and
+ * `defaultLocalization` (English) for the reference this was translated from.
+ */
+
+declare const fr: KerneLocalization;
+
+export { type DeepPartial as D, type KerneLocalization as K, type KerneAppearance as a, defaultTokens as b, defaultLocalization as d, fr as f, mergeLocalization as m, useLocalization as u };

package/dist/index.cjs

@@ -21,25 +21,27 @@
 
 
 
-var _chunkN6VPGJ36cjs = require('./chunk-N6VPGJ36.cjs');
+
+
+var _chunk3R66S7BYcjs = require('./chunk-3R66S7BY.cjs');
 
 // src/components.tsx
 var _react = require('react'); var _react2 = _interopRequireDefault(_react);
 var _jsxruntime = require('react/jsx-runtime');
 function Authenticated({ children, fallback = null }) {
-  const { isAuthenticated } = _chunkN6VPGJ36cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunk3R66S7BYcjs.useAuth.call(void 0, );
   return isAuthenticated ? children : fallback;
 }
 function Unauthenticated({ children, fallback = null }) {
-  const { isAuthenticated } = _chunkN6VPGJ36cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunk3R66S7BYcjs.useAuth.call(void 0, );
   return !isAuthenticated ? children : fallback;
 }
 function AuthLoading({ children }) {
-  const client = _chunkN6VPGJ36cjs.useClient.call(void 0, );
+  const client = _chunk3R66S7BYcjs.useClient.call(void 0, );
   return client.isLoading ? children : null;
 }
 function HasSubscription({ children, fallback = null }) {
-  const client = _chunkN6VPGJ36cjs.useClient.call(void 0, );
+  const client = _chunk3R66S7BYcjs.useClient.call(void 0, );
   const [hasSubscription, setHasSubscription] = _react2.default.useState(null);
   _react2.default.useEffect(() => {
     client.getSubscription().then((sub) => {
@@ -57,7 +59,7 @@ function Access({
   requested,
   fallback = null
 }) {
-  const { allowed, isLoading } = _chunkN6VPGJ36cjs.useAccess.call(void 0, featureKey, requested);
+  const { allowed, isLoading } = _chunk3R66S7BYcjs.useAccess.call(void 0, featureKey, requested);
   if (isLoading) return null;
   return allowed ? children : fallback;
 }
@@ -68,7 +70,7 @@ function Protected({
   authFallback = null,
   billingFallback = null
 }) {
-  const { isAuthenticated } = _chunkN6VPGJ36cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunk3R66S7BYcjs.useAuth.call(void 0, );
   if (auth && !isAuthenticated) {
     return authFallback;
   }
@@ -81,6 +83,37 @@ function Protected({
 // src/error-boundary.tsx
 
 
+var STYLE_ELEMENT_ID = "kerne-error-boundary-styles";
+var CSS = `
+.kerne-eb { padding: 24px; text-align: center; color: #16171a; }
+.kerne-eb-title { font-size: 20px; font-weight: 600; letter-spacing: -.01em; margin: 0 0 8px; }
+.kerne-eb-body { color: #6b7280; margin: 0 auto 20px; max-width: 40ch; font-size: 14px; line-height: 1.5; }
+.kerne-eb-code { color: #6f7681; margin: -12px 0 20px; font-size: 12px; }
+.kerne-eb-button {
+  font: inherit; font-size: 14px; font-weight: 500; height: 44px;
+  padding: 0 20px; border-radius: 8px; border: none; cursor: pointer;
+  background: #16171a; color: #fff;
+  transition: background-color .12s ease;
+}
+.kerne-eb-button:hover { background: #2c2e33; }
+.kerne-eb-button:focus-visible { outline: 2px solid #16171a; outline-offset: 2px; }
+@media (prefers-color-scheme: dark) {
+  .kerne-eb { color: #f0f1f3; }
+  .kerne-eb-body { color: #9ba2ad; }
+  .kerne-eb-code { color: #838b96; }
+  .kerne-eb-button { background: #f0f1f3; color: #16181d; }
+  .kerne-eb-button:hover { background: #d8dade; }
+  .kerne-eb-button:focus-visible { outline-color: #f0f1f3; }
+}
+`;
+function ensureErrorBoundaryStylesInjected() {
+  if (typeof document === "undefined") return;
+  if (document.getElementById(STYLE_ELEMENT_ID)) return;
+  const style = document.createElement("style");
+  style.id = STYLE_ELEMENT_ID;
+  style.textContent = CSS;
+  document.head.appendChild(style);
+}
 var KerneErrorBoundary = (_class = class extends _react.Component {
   constructor(props) {
     super(props);_class.prototype.__init.call(this);;
@@ -111,28 +144,15 @@ var KerneErrorBoundary = (_class = class extends _react.Component {
         }
         return fallback;
       }
-      return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { style: { padding: "20px", textAlign: "center" }, children: [
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { style: { color: "#dc2626", marginBottom: "10px" }, children: "Something went wrong" }),
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { style: { color: "#6b7280", marginBottom: "20px" }, children: error.message || "An unexpected error occurred" }),
-        error.code && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "p", { style: { color: "#9ca3af", fontSize: "12px", marginBottom: "20px" }, children: [
+      ensureErrorBoundaryStylesInjected();
+      return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "kerne-eb", children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: "kerne-eb-title", children: "Something went wrong" }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "kerne-eb-body", children: error.message || "An unexpected error occurred" }),
+        error.code && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "p", { className: "kerne-eb-code", children: [
           "Error code: ",
           error.code
         ] }),
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          "button",
-          {
-            onClick: this.reset,
-            style: {
-              padding: "10px 20px",
-              backgroundColor: "#3b82f6",
-              color: "white",
-              border: "none",
-              borderRadius: "6px",
-              cursor: "pointer"
-            },
-            children: "Try again"
-          }
-        )
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "button", { type: "button", className: "kerne-eb-button", onClick: this.reset, children: "Try again" })
       ] });
     }
     return this.props.children;
@@ -183,4 +203,6 @@ function useKerneError() {
 
 
 
-exports.Access = Access; exports.AuthLoading = AuthLoading; exports.Authenticated = Authenticated; exports.HasSubscription = HasSubscription; exports.KerneClient = _chunkN6VPGJ36cjs.KerneClient; exports.KerneContext = _chunkN6VPGJ36cjs.KerneContext; exports.KerneErrorBoundary = KerneErrorBoundary; exports.KerneProvider = _chunkN6VPGJ36cjs.KerneProvider; exports.Protected = Protected; exports.Unauthenticated = Unauthenticated; exports.defaultLocalization = _chunkN6VPGJ36cjs.defaultLocalization; exports.useAccess = _chunkN6VPGJ36cjs.useAccess; exports.useAuth = _chunkN6VPGJ36cjs.useAuth; exports.useAuthConfig = _chunkN6VPGJ36cjs.useAuthConfig; exports.useCancelSubscription = _chunkN6VPGJ36cjs.useCancelSubscription; exports.useChangePlan = _chunkN6VPGJ36cjs.useChangePlan; exports.useCheckout = _chunkN6VPGJ36cjs.useCheckout; exports.useClient = _chunkN6VPGJ36cjs.useClient; exports.useEntitlements = _chunkN6VPGJ36cjs.useEntitlements; exports.useInvitation = _chunkN6VPGJ36cjs.useInvitation; exports.useKerneError = useKerneError; exports.usePlanSwitch = _chunkN6VPGJ36cjs.usePlanSwitch; exports.usePlans = _chunkN6VPGJ36cjs.usePlans; exports.usePortal = _chunkN6VPGJ36cjs.usePortal; exports.useReportUsage = _chunkN6VPGJ36cjs.useReportUsage; exports.useSubscription = _chunkN6VPGJ36cjs.useSubscription; exports.useUsage = _chunkN6VPGJ36cjs.useUsage; exports.useUser = _chunkN6VPGJ36cjs.useUser; exports.useWaitlist = _chunkN6VPGJ36cjs.useWaitlist;
+
+
+exports.Access = Access; exports.AuthLoading = AuthLoading; exports.Authenticated = Authenticated; exports.HasSubscription = HasSubscription; exports.KerneClient = _chunk3R66S7BYcjs.KerneClient; exports.KerneContext = _chunk3R66S7BYcjs.KerneContext; exports.KerneErrorBoundary = KerneErrorBoundary; exports.KerneProvider = _chunk3R66S7BYcjs.KerneProvider; exports.Protected = Protected; exports.Unauthenticated = Unauthenticated; exports.defaultLocalization = _chunk3R66S7BYcjs.defaultLocalization; exports.fr = _chunk3R66S7BYcjs.fr; exports.mergeLocalization = _chunk3R66S7BYcjs.mergeLocalization; exports.useAccess = _chunk3R66S7BYcjs.useAccess; exports.useAuth = _chunk3R66S7BYcjs.useAuth; exports.useAuthConfig = _chunk3R66S7BYcjs.useAuthConfig; exports.useCancelSubscription = _chunk3R66S7BYcjs.useCancelSubscription; exports.useChangePlan = _chunk3R66S7BYcjs.useChangePlan; exports.useCheckout = _chunk3R66S7BYcjs.useCheckout; exports.useClient = _chunk3R66S7BYcjs.useClient; exports.useEntitlements = _chunk3R66S7BYcjs.useEntitlements; exports.useInvitation = _chunk3R66S7BYcjs.useInvitation; exports.useKerneError = useKerneError; exports.usePlanSwitch = _chunk3R66S7BYcjs.usePlanSwitch; exports.usePlans = _chunk3R66S7BYcjs.usePlans; exports.usePortal = _chunk3R66S7BYcjs.usePortal; exports.useReportUsage = _chunk3R66S7BYcjs.useReportUsage; exports.useSubscription = _chunk3R66S7BYcjs.useSubscription; exports.useUsage = _chunk3R66S7BYcjs.useUsage; exports.useUser = _chunk3R66S7BYcjs.useUser; exports.useWaitlist = _chunk3R66S7BYcjs.useWaitlist;

package/dist/index.d.cts

@@ -3,10 +3,10 @@ import React, { ReactNode, Component, ErrorInfo } from 'react';
 import { KerneConfig, ConsumeParams, ReportUsageParams, ReportUsageBatchEvent, BatchUsageResult, JoinWaitlistParams, ValidateTokenResponse, ValidateCodeResponse } from '@kerne/server';
 export { JoinWaitlistParams, ValidateCodeResponse, ValidateTokenResponse, WaitlistEntry } from '@kerne/server';
 import * as _kerne_types from '@kerne/types';
-import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, UsageRecord, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, PublicPlanPrice } from '@kerne/types';
+import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, UsageRecord, DriverSelection, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, PublicPlanPrice } from '@kerne/types';
 export { ActivationContext, AuthConfig, AuthResponse, BatchUsageResult, EntitlementCheck, Entitlements, PublicPlan, Subscription, SubscriptionWithPlan, UsageRecord, User, ValidationFieldError } from '@kerne/types';
-import { D as DeepPartial, K as KerneLocalization } from './i18n-CXEhPK58.cjs';
-export { d as defaultLocalization } from './i18n-CXEhPK58.cjs';
+import { D as DeepPartial, K as KerneLocalization, a as KerneAppearance } from './fr-E5mmylSH.cjs';
+export { d as defaultLocalization, f as fr, m as mergeLocalization } from './fr-E5mmylSH.cjs';
 
 interface KerneReactConfig extends Omit<KerneConfig, 'secretKey'> {
     storage?: Storage;
@@ -119,14 +119,14 @@ declare class KerneClient {
     /** Soft-deletes (deactivates) the caller's own account, then clears the local session. */
     requestAccountDeletion(): Promise<void>;
     /** Forgot-password flow (logged out) - sends the reset email. */
-    requestPasswordReset(email: string, callbackUrl?: string): Promise<void>;
+    requestPasswordReset(email: string): Promise<void>;
     /** Confirms a password reset with the token from the email. */
     confirmPasswordReset(token: string, password: string): Promise<void>;
     /**
      * Sends a magic-link email (logged out). Anti-enumeration: always resolves,
      * regardless of whether the email is registered.
      */
-    startPasswordless(email: string, callbackUrl?: string, invitation?: {
+    startPasswordless(email: string, invitation?: {
         invitationToken?: string;
         invitationCode?: string;
     }): Promise<void>;
@@ -173,16 +173,10 @@ declare class KerneClient {
     /** Several usage events in one request instead of one call each - kills the manual request staggering. */
     reportUsageBatch(events: Array<Omit<ReportUsageBatchEvent, 'subject'>>): Promise<BatchUsageResult[]>;
     private requireUserId;
-    createCheckout(planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }): Promise<string>;
-    openCheckout(planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }): Promise<void>;
-    createPortal(returnUrl?: string): Promise<string>;
-    openPortal(returnUrl?: string): Promise<void>;
+    createCheckout(planPriceId: string, drivers?: DriverSelection[]): Promise<string>;
+    openCheckout(planPriceId: string, drivers?: DriverSelection[]): Promise<void>;
+    createPortal(): Promise<string>;
+    openPortal(): Promise<void>;
     getSubscription(productSlug?: string): Promise<SubscriptionWithPlan | null>;
     /** `immediately: true` ends it now; otherwise cancels at period end (API default). */
     cancelSubscription(subscriptionId: string, immediately?: boolean): Promise<Subscription>;
@@ -203,7 +197,7 @@ declare class KerneClient {
     validateInvitationToken(token: string): Promise<ValidateTokenResponse>;
     /** Validate an invitation code before showing the registration form. */
     validateInvitationCode(code: string): Promise<ValidateCodeResponse>;
-    sendVerificationEmail(verificationType?: 'code' | 'link', callbackUrl?: string): Promise<void>;
+    sendVerificationEmail(verificationType?: 'code' | 'link'): Promise<void>;
     verifyEmailWithCode(code: string): Promise<{
         success: boolean;
         needsTokenRefresh: boolean;
@@ -229,8 +223,14 @@ interface KerneProviderProps extends KerneReactConfig {
      * override keeps everything it does not mention.
      */
     localization?: DeepPartial<KerneLocalization>;
+    /**
+     * Appearance for every prebuilt component, set once. A host with its own dark
+     * mode would otherwise pass it to each one and keep them in sync by hand; a
+     * component's own `appearance` still wins, field by field.
+     */
+    appearance?: KerneAppearance;
 }
-declare function KerneProvider({ children, localization, ...config }: KerneProviderProps): react_jsx_runtime.JSX.Element;
+declare function KerneProvider({ children, localization, appearance, ...config }: KerneProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Access the Kerne client instance
@@ -273,14 +273,14 @@ declare function useAuth(): {
         newPassword: string;
     }) => Promise<void>;
     requestAccountDeletion: () => Promise<void>;
-    requestPasswordReset: (email: string, callbackUrl?: string) => Promise<void>;
+    requestPasswordReset: (email: string) => Promise<void>;
     confirmPasswordReset: (token: string, password: string) => Promise<void>;
-    startPasswordless: (email: string, callbackUrl?: string, invitation?: {
+    startPasswordless: (email: string, invitation?: {
         invitationToken?: string;
         invitationCode?: string;
     }) => Promise<void>;
     loginWithMagicLink: (token: string) => Promise<_kerne_types.AuthResponse>;
-    sendVerificationEmail: (verificationType?: "code" | "link", callbackUrl?: string) => Promise<void>;
+    sendVerificationEmail: (verificationType?: "code" | "link") => Promise<void>;
     verifyEmailWithCode: (code: string) => Promise<{
         success: boolean;
         needsTokenRefresh: boolean;
@@ -308,14 +308,8 @@ declare function useAuth(): {
  * ```
  */
 declare function useCheckout(): {
-    createCheckout: (planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }) => Promise<string>;
-    openCheckout: (planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }) => Promise<void>;
+    createCheckout: (planPriceId: string, drivers?: DriverSelection[]) => Promise<string>;
+    openCheckout: (planPriceId: string, drivers?: DriverSelection[]) => Promise<void>;
 };
 /**
  * Billing portal hook - lets a user manage their subscription/payment method.
@@ -327,8 +321,8 @@ declare function useCheckout(): {
  * ```
  */
 declare function usePortal(): {
-    createPortal: (returnUrl?: string) => Promise<string>;
-    openPortal: (returnUrl?: string) => Promise<void>;
+    createPortal: () => Promise<string>;
+    openPortal: () => Promise<void>;
 };
 /**
  * Cancels or changes the current scope's own subscription - JWT-scoped like every other hook
@@ -383,16 +377,13 @@ interface PlanSwitchTarget {
  *   usePlanSwitch(subscription, refetch);
  * ```
  */
-declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void, options?: {
-    successUrl?: string;
-    cancelUrl?: string;
-}): {
+declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void): {
     pending: PlanSwitchTarget | null;
     switching: boolean;
     switchError: unknown;
     checkoutPriceId: string | null;
     checkoutError: unknown;
-    selectPlan: (plan: PublicPlan, price: PublicPlanPrice) => Promise<void>;
+    selectPlan: (plan: PublicPlan, price: PublicPlanPrice, drivers?: DriverSelection[]) => Promise<void>;
     confirmSwitch: () => Promise<void>;
     dismissSwitch: () => void;
 };
@@ -475,9 +466,13 @@ declare function useAuthConfig(): {
 };
 /**
  * Every entitlement for the current user in one call - for a "your plan"
- * screen. Use `useAccess` instead for a single feature - this response
- * never carries `allowed` (see docs: the list is cached, a stale verdict
- * would be unsafe).
+ * screen. `EntitlementSummary` carries no `allowed` field, on purpose: this
+ * list is a cached snapshot for display ("12/50 calls used"), not a live
+ * verdict. **Never gate access by reading `limit`/`remaining`/`enabled`
+ * yourself** - that silently reimplements override precedence, overage
+ * rules, and the race against concurrent usage that `useAccess()` already
+ * handles server-side. Use `useAccess()` (or `kerne.allows()`/`enforce()`)
+ * for every actual gate, and this hook only to render numbers.
  *
  * @example
  * ```tsx