@buoy-gg/shared-ui 7.0.22 → 7.0.24

package/lib/typescript/module/dataViewer/index.d.ts

@@ -19,6 +19,12 @@ export { SplitDiffViewer } from "./SplitDiffViewer";
 export type { SplitDiffViewerProps, SplitDiffViewerOptions } from "./SplitDiffViewer";
 export { DiffSummary } from "./DiffSummary";
 export type { DiffSummaryProps } from "./DiffSummary";
+export { TimestampDeltaBar } from "./TimestampDeltaBar";
+export { JsonStringNotice } from "./JsonStringNotice";
+export { decodeJsonStringPair, parseJsonContainer } from "./jsonStringValue";
+export type { DecodedJsonPair } from "./jsonStringValue";
+export { detectTimestamp, describeTimestampDeltas, formatDuration, formatInstant, } from "./timestampDiff";
+export type { DetectedTimestamp, TimestampDelta, TimestampKind, } from "./timestampDiff";
 export { computeLineDiff, DiffType, ABSENT_VALUE, isAbsent, type LineDiffInfo, type WordDiff, type DiffComputeOptions, } from "./lineDiff";
 export { diffThemes, gitClassicTheme, devToolsDefaultTheme, type DiffTheme, type DiffThemeKey, } from "./diffThemes";
 export { objectDiff, boundedDeepEqual, toDiffable, jsonLikelyLargerThan, type ObjectDiffOptions, type ObjectDiffResult, } from "./objectDiff";

package/lib/typescript/module/dataViewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dataViewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C;;;;GAIG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIlE,OAAO,EACL,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,MAAM,GACZ,MAAM,WAAW,CAAC;AAInB,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAIvB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dataViewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C;;;;GAIG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIlE,OAAO,EACL,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,MAAM,GACZ,MAAM,WAAW,CAAC;AAInB,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAIvB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/lib/typescript/module/dataViewer/jsonStringValue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parse a string that encodes a JSON object or array. Returns a wrapper so a
+ * successfully decoded `null`-ish payload is still distinguishable from "not
+ * decodable" (the prefix check makes that unreachable today, but callers
+ * shouldn't have to know that).
+ */
+export declare function parseJsonContainer(value: unknown): {
+    value: unknown;
+} | null;
+export interface DecodedJsonPair {
+    left: unknown;
+    right: unknown;
+    /** True when the pair was unwrapped and the UI must say so. */
+    decoded: boolean;
+}
+/**
+ * Decode both sides of a diff when they are JSON-encoded containers.
+ *
+ * One side alone is decoded ONLY when the other side is missing entirely
+ * (a key being added or removed). A JSON string on one side and an ordinary
+ * value on the other is a change of shape, and decoding just one half would
+ * present it as something it isn't.
+ */
+export declare function decodeJsonStringPair(left: unknown, right: unknown): DecodedJsonPair;
+//# sourceMappingURL=jsonStringValue.d.ts.map

package/lib/typescript/module/dataViewer/jsonStringValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonStringValue.d.ts","sourceRoot":"","sources":["../../../../src/dataViewer/jsonStringValue.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAa5E;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,eAAe,CAcjB"}

package/lib/typescript/module/dataViewer/timestampDiff.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Timestamp detection for diff views.
+ *
+ * `1787085897165 → 1787012175875` is unreadable. It is also the single most
+ * common diff in a devtool: `lastSyncTimestamp`, `expiresAt`, `updatedAt`,
+ * every cache stamp. This turns that pair into "20h 29m earlier" plus both
+ * instants spelled out, WITHOUT hiding the raw values — a devtool that
+ * silently reinterprets what is stored is worse than one that says nothing.
+ *
+ * DETECTION IS DELIBERATELY NARROW, because the failure mode is confidently
+ * mislabelling an id or a counter as a date:
+ *  - Epoch milliseconds only in [2001-09-09, 2100), i.e. 13 digits.
+ *  - Epoch seconds only in the same window, i.e. 10 digits.
+ *    The two ranges cannot overlap, so a value is never ambiguous.
+ *  - ISO 8601 strings that both match the shape AND parse.
+ *  - BOTH sides must be the same kind. An ISO string against an epoch number
+ *    is a representation change, not a time delta, and reporting a gap there
+ *    would bury the more interesting fact.
+ */
+/** Units we recognize. A pair must agree on one of them. */
+export type TimestampKind = "epoch-ms" | "epoch-s" | "iso";
+export interface DetectedTimestamp {
+    kind: TimestampKind;
+    epochMs: number;
+}
+export interface TimestampDelta {
+    /** Object key this pair came from; absent when the value itself is a time. */
+    path?: string;
+    kind: TimestampKind;
+    /** Signed: new − old. Negative means the new value is earlier. */
+    deltaMs: number;
+    /** "20h 29m earlier" · "4s later" · "same instant". */
+    deltaLabel: string;
+    /** Both sides as local wall-clock, e.g. "2026-08-18 18:31:37". */
+    fromLabel: string;
+    toLabel: string;
+}
+/**
+ * Read one value as an instant, or null when it isn't confidently a time.
+ * Numeric strings count: storage backends hand back everything as strings.
+ */
+export declare function detectTimestamp(value: unknown): DetectedTimestamp | null;
+/** Local wall-clock, fixed format — a devtool wants it sortable, not chatty. */
+export declare function formatInstant(epochMs: number): string;
+/** Coarsest two units that still carry the magnitude: "3d 4h", "5m 30s". */
+export declare function formatDuration(ms: number): string;
+/**
+ * Every timestamp pair worth explaining in a diff of these two values.
+ *
+ * Scalars give at most one entry. Plain objects are inspected ONE level deep
+ * — enough for the `{ updatedAt, expiresAt }` shape that dominates, without
+ * walking a whole document to hunt for dates.
+ */
+export declare function describeTimestampDeltas(oldValue: unknown, newValue: unknown): TimestampDelta[];
+//# sourceMappingURL=timestampDiff.d.ts.map

package/lib/typescript/module/dataViewer/timestampDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestampDiff.d.ts","sourceRoot":"","sources":["../../../../src/dataViewer/timestampDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAcxE;AAMD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAejD;AAqCD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,GAChB,cAAc,EAAE,CAgBlB"}

package/lib/typescript/module/hooks/safe-area-impl.d.ts

@@ -1,7 +1,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-18T00:32:52.026Z
+ * Generated at: 2026-08-19T20:50:51.001Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/typescript/module/index.d.ts

@@ -29,6 +29,6 @@ export type { Environment } from "./types/types";
 export { normalizeEnvironment } from "./types/types";
 export { HintsProvider, useHintsDisabled, useHintsContext } from "./context";
 export * from "./history";
-export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, LicenseEntryModal, ProBadge, ProUpgradeModal, getUseIsPro, getUseLicense } from "./license";
-export type { FeatureGateProps, ProFeatureBannerProps, UpgradeModalProps, LicenseEntryModalProps, ProUpgradeModalProps } from "./license";
+export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, LicenseEntryModal, ProBadge, ProUpgradeModal, FreeAccountPrompt, LOGIN_COMMAND, getUseIsPro, getUseLicense, getUseTier, TIER_LIMITS, useLimit, resolveEffectiveTier, freeKeyRaises } from "./license";
+export type { FeatureGateProps, ProFeatureBannerProps, UpgradeModalProps, LicenseEntryModalProps, ProUpgradeModalProps, FreeAccountPromptProps, BuoyTier, TierLimitKey } from "./license";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AAGrB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAEL,YAAY,EAEZ,YAAY,EACZ,iBAAiB,EAEjB,iBAAiB,EAEjB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EAErB,aAAa,EAEb,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,EAEZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EAEV,kBAAkB,EAClB,uBAAuB,EAEvB,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EAEtB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAEhC,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EAEpB,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAG3B,kBAAkB,EAElB,YAAY,EACZ,KAAK,oBAAoB,EAEzB,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,EAE3B,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,YAAY,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG7E,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3R,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/lib/typescript/module/license/FeatureGate.d.ts

@@ -4,6 +4,7 @@
  * Wraps premium features and shows an upgrade prompt for free users.
  */
 import React, { ReactNode } from "react";
+import { type TierLimitKey } from "./tierLimits";
 import type { ProAccessReason } from "@buoy-gg/license";
 export declare const WEEKEND_PASS_LABEL = "WEEKEND PASS";
 /**
@@ -24,8 +25,10 @@ export interface ProUpgradeModalProps {
     visible: boolean;
     onClose: () => void;
     featureName?: string;
+    /** See {@link UpgradeModalProps.limitKey}. */
+    limitKey?: TierLimitKey;
 }
-export declare const ProUpgradeModal: ({ visible, onClose, featureName, }: ProUpgradeModalProps) => React.JSX.Element;
+export declare const ProUpgradeModal: ({ visible, onClose, featureName, limitKey, }: ProUpgradeModalProps) => React.JSX.Element;
 export interface FeatureGateProps {
     /**
      * Content to render when user has Pro access
@@ -55,10 +58,12 @@ export interface FeatureGateProps {
  * Default upgrade prompt shown when user doesn't have Pro access
  * Opens LicenseEntryModal when clicked (unless custom onUpgradePress provided)
  */
-export declare const UpgradePrompt: ({ featureName, onUpgradePress, compact, }: {
+export declare const UpgradePrompt: ({ featureName, onUpgradePress, compact, limitKey, }: {
     featureName?: string;
     onUpgradePress?: () => void;
     compact?: boolean;
+    /** See {@link UpgradeModalProps.limitKey}. */
+    limitKey?: TierLimitKey;
 }) => React.JSX.Element;
 /**
  * Wraps content that requires Pro license.
@@ -131,6 +136,17 @@ export interface UpgradeModalProps {
      * List of Pro benefits to highlight
      */
     benefits?: string[];
+    /**
+     * The tier limit the user just hit, if this upsell is about a limit rather
+     * than a Pro-exclusive feature.
+     *
+     * Supplying it is what lets an anonymous user be offered a FREE key instead
+     * of a paid upgrade — but only when a free key would genuinely raise that
+     * limit. Omit it for Pro-only features (copy, state editing, storage
+     * mutations, navigation): those are locked for free users too, so promising
+     * a free key would be a lie.
+     */
+    limitKey?: TierLimitKey;
 }
-export declare const UpgradeModal: ({ visible, onClose, featureName, description, benefits, }: UpgradeModalProps) => React.JSX.Element | null;
+export declare const UpgradeModal: ({ visible, onClose, featureName, description, benefits, limitKey, }: UpgradeModalProps) => React.JSX.Element | null;
 //# sourceMappingURL=FeatureGate.d.ts.map

package/lib/typescript/module/license/FeatureGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/license/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAyB,MAAM,OAAO,CAAC;AAOhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,sBAUrD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,GAAI,oCAI7B,oBAAoB,sBAUtB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,2CAI3B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,sBAiEA,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,mEAMzB,gBAAgB,sBAiClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAeA;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,GAAI,yCAI9B,qBAAqB,sBA+DvB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,GAAI,2DAM1B,iBAAiB,6BAuHnB,CAAC"}
+{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/license/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAyB,MAAM,OAAO,CAAC;AAQhE,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,sBAUrD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,GAAI,8CAK7B,oBAAoB,sBAiBtB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,qDAK3B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,sBA6FA,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,mEAMzB,gBAAgB,sBAiClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAeA;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,GAAI,yCAI9B,qBAAqB,sBA+DvB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,GAAI,qEAO1B,iBAAiB,6BAwInB,CAAC"}

package/lib/typescript/module/license/FreeAccountPrompt.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The upsell an ANONYMOUS user sees — someone with no key at all.
+ *
+ * Deliberately not the Pro modal. Their next step is free and takes about
+ * thirty seconds, so asking them for money would be asking the wrong question
+ * at the wrong moment, and would suppress exactly the signup this exists to
+ * produce. Pro is still offered, as a secondary action.
+ *
+ * The command is shown inline and copyable rather than linked, because there is
+ * no grace period: someone who just watched their limits shrink needs the fix
+ * in front of them, not a link to a page that has a link to a command.
+ */
+import React from "react";
+/** The one thing a reader has to be able to act on. */
+export declare const LOGIN_COMMAND = "npx buoy login";
+export interface FreeAccountPromptProps {
+    visible: boolean;
+    onClose: () => void;
+    /** What the user just bumped into, e.g. "Network requests". */
+    featureName?: string;
+}
+export declare const FreeAccountPrompt: ({ visible, onClose, featureName, }: FreeAccountPromptProps) => React.JSX.Element | null;
+//# sourceMappingURL=FreeAccountPrompt.d.ts.map

package/lib/typescript/module/license/FreeAccountPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreeAccountPrompt.d.ts","sourceRoot":"","sources":["../../../../src/license/FreeAccountPrompt.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAaxE,uDAAuD;AACvD,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,GAAI,oCAI/B,sBAAsB,6BAoFxB,CAAC"}

package/lib/typescript/module/license/index.d.ts

@@ -1,20 +1,11 @@
 export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, ProBadge, ProUpgradeModal } from "./FeatureGate";
 export type { FeatureGateProps, ProFeatureBannerProps, UpgradeModalProps, ProUpgradeModalProps } from "./FeatureGate";
 export { LicenseEntryModal } from "./LicenseEntryModal";
+export { FreeAccountPrompt, LOGIN_COMMAND } from "./FreeAccountPrompt";
+export type { FreeAccountPromptProps } from "./FreeAccountPrompt";
 export type { LicenseEntryModalProps, LicenseState } from "./LicenseEntryModal";
-import type { LicenseState as LicenseStateType } from "./LicenseEntryModal";
-/**
- * Get the useIsPro hook from @buoy-gg/license
- * Falls back to () => false if license package is not available
- *
- * IMPORTANT: Use this instead of doing your own lazy loading in other packages
- */
-export declare function getUseIsPro(): () => boolean;
-/**
- * Get the useLicense hook from @buoy-gg/license
- * Returns null if license package is not available
- *
- * IMPORTANT: Use this instead of doing your own lazy loading in other packages
- */
-export declare function getUseLicense(): (() => LicenseStateType) | null;
+export { getUseIsPro, getUseLicense, getUseTier, } from "./licenseModule";
+export type { BuoyTier } from "./licenseModule";
+export { TIER_LIMITS, useLimit, resolveEffectiveTier, freeKeyRaises } from "./tierLimits";
+export type { TierLimitKey } from "./tierLimits";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/license/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/license/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtI,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEtH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAuB5E;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,OAAO,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,CAAC,MAAM,gBAAgB,CAAC,GAAG,IAAI,CAG/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/license/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtI,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEtH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIhF,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/module/license/licenseModule.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Centralized lazy loading of `@buoy-gg/license`.
+ *
+ * This is the SINGLE place any package resolves license hooks — tools must not
+ * `require("@buoy-gg/license")` themselves. Lives in its own module (rather
+ * than `./index`) so `tierLimits` can consume it without an import cycle.
+ */
+import type { LicenseState as LicenseStateType } from "./LicenseEntryModal";
+/** Access tier. Mirrors BuoyTier in @buoy-gg/license. */
+export type BuoyTier = "anonymous" | "free" | "pro";
+/**
+ * Get the useIsPro hook from @buoy-gg/license.
+ * Falls back to () => false if the license package is not available.
+ *
+ * IMPORTANT: Use this instead of doing your own lazy loading in other packages
+ */
+export declare function getUseIsPro(): () => boolean;
+/**
+ * Get the useLicense hook from @buoy-gg/license.
+ * Returns null if the license package is not available.
+ *
+ * IMPORTANT: Use this instead of doing your own lazy loading in other packages
+ */
+export declare function getUseLicense(): (() => LicenseStateType) | null;
+/**
+ * Get the useTier hook from @buoy-gg/license.
+ *
+ * Falls back to `"free"` — NOT `"anonymous"` — when the license package can't
+ * be resolved. That deliberately matches the existing `getUseIsPro()` fallback,
+ * which yields free-tier behavior today, and it picks the safer failure:
+ *
+ *  - falling back to "anonymous" would let one bundler quirk silently cut every
+ *    legitimate user's limits by ~80%;
+ *  - falling back to "free" costs no revenue, because Pro still requires a key
+ *    that a live license server validated — this path can never grant Pro.
+ *
+ * Reaching it at all requires `@buoy-gg/license` to be missing, and it is a
+ * hard dependency of `@buoy-gg/core`.
+ */
+export declare function getUseTier(): () => BuoyTier;
+/**
+ * Whether the anonymous tier is switched on.
+ *
+ * The switch itself lives in @buoy-gg/license (see its config.ts) because the
+ * Weekend Pass change has to flip at the same moment as the reduced limits, and
+ * those live in different packages. Read through the same lazy loader as the
+ * hooks so a missing license package degrades gracefully rather than throwing
+ * at module load.
+ *
+ * Falls back to `false` — the anonymous tier off, everyone on free limits —
+ * which matches the `getUseTier()` fallback of "free". A build that cannot
+ * resolve the license package must never take limits AWAY from someone.
+ */
+export declare function isAnonymousTierEnabled(): boolean;
+//# sourceMappingURL=licenseModule.d.ts.map

package/lib/typescript/module/license/licenseModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenseModule.d.ts","sourceRoot":"","sources":["../../../../src/license/licenseModule.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AA4BpD;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,OAAO,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,CAAC,MAAM,gBAAgB,CAAC,GAAG,IAAI,CAG/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,IAAI,MAAM,QAAQ,CAG3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD"}

package/lib/typescript/module/license/tierLimits.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Per-tier numeric limits — the ONLY thing that separates anonymous from free.
+ *
+ * Every binary Pro gate (copy-to-clipboard, state editing, storage mutations,
+ * navigation) is identical for both: locked. That keeps the tier split to one
+ * table instead of scattered conditionals.
+ *
+ * The governing rule: **the free column never moves.** Anonymous is carved out
+ * BELOW today's free tier — nothing is ever added to free in exchange for an
+ * account, because that would come straight out of the Pro upgrade.
+ */
+import { type BuoyTier } from "./licenseModule";
+interface TierLimit {
+    /** No credential — a trial: every tool visible, much smaller caps. */
+    readonly anonymous: number;
+    /** A validated key on the Free policy. Today's free tier, unchanged. */
+    readonly free: number;
+    /** A validated key on the Solo or Business policy. */
+    readonly pro: number;
+}
+declare const LIMITS: {
+    "network.requests": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "network.saved": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "network.overrideRules": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "storage.events": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "storage.keys": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "storage.mmkvInstances": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "redux.actions": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "zustand.changes": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "jotai.changes": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "events.entries": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "highlightUpdates.components": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "highlightUpdates.historyEvents": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "highlightUpdates.detailEvents": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "routeEvents.entries": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "timeMachine.snapshots": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+    "perfMonitor.automationCases": {
+        anonymous: number;
+        free: number;
+        pro: number;
+    };
+};
+export type TierLimitKey = keyof typeof LIMITS;
+export declare const TIER_LIMITS: Record<TierLimitKey, TierLimit>;
+/**
+ * The tier whose limits actually apply.
+ *
+ * `hasProAccess` is `useIsPro()`, which is true for a real Pro license OR the
+ * free Weekend Pass. Routing the Weekend Pass through here is what keeps
+ * today's behavior intact: weekend users get Pro limits, exactly as they do
+ * now. When the Weekend Pass is later gated to key-holders, that change lands
+ * here for free — no limit call site has to know about it.
+ */
+export declare function resolveEffectiveTier(tier: BuoyTier, hasProAccess: boolean): BuoyTier;
+/**
+ * The limit for the current tier.
+ *
+ * Replaces the per-package `const FREE_TIER_X = 25` + `isPro ? Infinity : X`
+ * pattern. `Infinity` is returned for uncapped tiers and is safe to use
+ * directly in `slice(0, limit)` and `length >= limit` comparisons.
+ */
+export declare function useLimit(key: TierLimitKey): number;
+/**
+ * Whether claiming a FREE key would actually raise this limit right now.
+ *
+ * The anonymous upsell must never promise something a free key won't deliver.
+ * Two ways it could lie, and this closes both:
+ *
+ *  - **Pro-exclusive features.** Copy-to-clipboard, state editing, storage
+ *    mutations and navigation are locked for anonymous AND free alike. Telling
+ *    an anonymous user a free key opens them would be false.
+ *  - **Limits that are already equal.** Override rules and MMKV instances sit
+ *    at 1 for both tiers, so a key changes nothing there either.
+ *
+ * It also respects `ANONYMOUS_TIER_ENABLED`: while the anonymous tier is off,
+ * an anonymous user is *already* getting the free limits, so there is nothing
+ * to claim and this correctly returns false everywhere. That falls out of
+ * asking `resolveEffectiveTier` rather than reading the table directly, so the
+ * switch and the copy can never disagree.
+ */
+export declare function freeKeyRaises(key: TierLimitKey): boolean;
+export {};
+//# sourceMappingURL=tierLimits.d.ts.map

package/lib/typescript/module/license/tierLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierLimits.d.ts","sourceRoot":"","sources":["../../../../src/license/tierLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAEzB,UAAU,SAAS;IACjB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BX,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,MAAM,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,CAAU,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,OAAO,GACpB,QAAQ,CAMV;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAIlD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAMxD"}

package/lib/typescript/module/ui/backgrounds/BackgroundSwitcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The ‹ prev / next › strip for auditioning backgrounds.
+ *
+ * This is a REVIEW control, not shipped chrome: it exists so the whole
+ * catalogue can be walked without a rebuild, with the cost of each preset shown
+ * next to its name. Mount it at the top of a tool's body while evaluating, and
+ * pull it once a winner is picked (or keep it behind a setting).
+ *
+ * It writes to the shared `backgroundStore`, so stepping here changes the
+ * background in every tool at once.
+ */
+export declare const BackgroundSwitcher: import("react").NamedExoticComponent<object>;
+//# sourceMappingURL=BackgroundSwitcher.d.ts.map

package/lib/typescript/module/ui/backgrounds/BackgroundSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundSwitcher.d.ts","sourceRoot":"","sources":["../../../../../src/ui/backgrounds/BackgroundSwitcher.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,eAAO,MAAM,kBAAkB,8CA6D7B,CAAC"}

package/lib/typescript/module/ui/backgrounds/ToolBackground.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Drop-in animated backdrop for a Buoy tool surface.
+ *
+ * Mount it as the FIRST child of a tool's body container and everything after
+ * it draws on top:
+ *
+ *   <View style={styles.container}>
+ *     <ToolBackground />
+ *     ...screens...
+ *   </View>
+ *
+ * It is `position: absolute` + `pointerEvents: "none"`, so it never affects
+ * layout and never eats a touch. The preset comes from the shared persisted
+ * selection (`backgroundStore`), so switching it in one tool switches it in all
+ * of them.
+ */
+import type { BackgroundId } from "./types";
+export interface ToolBackgroundProps {
+    /**
+     * Force a specific preset instead of following the shared selection. The
+     * switcher's live preview uses this; tools should omit it.
+     */
+    id?: BackgroundId;
+    /** Force motion off regardless of the shared setting. */
+    motion?: boolean;
+    /** Multiplied into the whole layer's opacity — dial it down per tool. */
+    opacity?: number;
+}
+export declare const ToolBackground: import("react").NamedExoticComponent<ToolBackgroundProps>;
+//# sourceMappingURL=ToolBackground.d.ts.map

package/lib/typescript/module/ui/backgrounds/ToolBackground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolBackground.d.ts","sourceRoot":"","sources":["../../../../../src/ui/backgrounds/ToolBackground.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAU5C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,2DAgCzB,CAAC"}

package/lib/typescript/module/ui/backgrounds/backgroundStore.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The persisted background selection, shared by every tool.
+ *
+ * A singleton rather than context so a tool anywhere in the tree — modal,
+ * inline desktop panel, bottom sheet — reads the same choice without a provider
+ * having to wrap it. Same shape as `ignoredPatternsStore`: subscribe/notify,
+ * best-effort persistence, a dirty flag so a slow initial read can't clobber a
+ * choice the user already made.
+ */
+import type { BackgroundId } from "./types";
+type Listener = () => void;
+declare class BackgroundStore {
+    private id;
+    private motion;
+    private readonly listeners;
+    private loadPromise;
+    private dirty;
+    getId(): BackgroundId;
+    getMotion(): boolean;
+    subscribe(listener: Listener): () => void;
+    private notify;
+    private load;
+    private persist;
+    setId(id: BackgroundId): void;
+    /** Step through the catalogue; `delta` is +1 (next) or -1 (previous). */
+    step(delta: number): void;
+    setMotion(motion: boolean): void;
+}
+export declare const backgroundStore: BackgroundStore;
+export interface UseToolBackgroundResult {
+    id: BackgroundId;
+    motion: boolean;
+    index: number;
+    count: number;
+    setId: (id: BackgroundId) => void;
+    next: () => void;
+    previous: () => void;
+    setMotion: (motion: boolean) => void;
+}
+/** Subscribe a component to the current background selection. */
+export declare function useToolBackground(): UseToolBackgroundResult;
+export {};
+//# sourceMappingURL=backgroundStore.d.ts.map

package/lib/typescript/module/ui/backgrounds/backgroundStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundStore.d.ts","sourceRoot":"","sources":["../../../../../src/ui/backgrounds/backgroundStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAS5C,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAQ3B,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAoC;IAC9C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,KAAK,CAAS;IAEtB,KAAK,IAAI,YAAY;IAIrB,SAAS,IAAI,OAAO;IAIpB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAQzC,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,OAAO;IAMf,KAAK,CAAC,EAAE,EAAE,YAAY;IAOtB,yEAAyE;IACzE,IAAI,CAAC,KAAK,EAAE,MAAM;IAIlB,SAAS,CAAC,MAAM,EAAE,OAAO;CAM1B;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,IAAI,uBAAuB,CAuB3D"}

package/lib/typescript/module/ui/backgrounds/index.d.ts

@@ -0,0 +1,7 @@
+export { ToolBackground, type ToolBackgroundProps } from "./ToolBackground";
+export { BackgroundSwitcher } from "./BackgroundSwitcher";
+export { backgroundStore, useToolBackground, type UseToolBackgroundResult, } from "./backgroundStore";
+export { BACKGROUND_PRESETS, DEFAULT_BACKGROUND, getPreset, presetAt, presetIndex, type BackgroundPreset, } from "./registry";
+export type { BackgroundId, BackgroundVariantProps } from "./types";
+export { DeepFieldTunable, type DeepFieldTuning, type HaloMode, type TwinkleMode, } from "./variants/deepField";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/ui/backgrounds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ui/backgrounds/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC"}