@buoy-gg/shared-ui 7.0.16 → 7.0.17

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

@@ -7,6 +7,8 @@ export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstruc
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, } from "./valueFormatting";
 export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule";
 export { setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, } from "./renderCaptureRegistry";
+export { registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, } from "./stateSnapshotRegistry";
+export { serialize as superJsonSerialize, deserialize as superJsonDeserialize, type SuperJSONResult, } from "./minimalSuperJSON";
 export { reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, } from "./reloadApp";
 export { Subscribable, type SubscribableListener } from "./subscribable";
 export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, } from "./subscriberCountNotifier";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,IAAI,kBAAkB,EAC/B,WAAW,IAAI,oBAAoB,EACnC,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/lib/typescript/module/utils/stateSnapshotRegistry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Cross-package bridge for app-state snapshot & restore (Time Machine).
+ *
+ * Each state tool (`@buoy-gg/storage`, `@buoy-gg/redux`, `@buoy-gg/zustand`,
+ * `@buoy-gg/jotai`, `@buoy-gg/react-query`) registers a provider here at
+ * module init (or from its app-lifetime sync hook); `@buoy-gg/time-machine`
+ * consumes the registry. Neither side imports the other — same
+ * optional-capability pattern as renderCaptureRegistry.
+ *
+ * Apps can also register custom providers for state Buoy doesn't know about.
+ */
+export interface StateSnapshotProviderStatus {
+    canCapture: boolean;
+    canRestore: boolean;
+    /** Human-actionable reason when a capability is unavailable. */
+    detail?: string;
+}
+export interface StateSnapshotCapture {
+    /**
+     * Raw JS value tree. May contain Date/Map/Set/etc. (the vault serializes
+     * with superjson) but MUST NOT contain functions — providers strip them
+     * and record how to re-graft on restore inside their own data envelope.
+     */
+    data: unknown;
+    warnings: string[];
+}
+export interface StateSnapshotRestoreResult {
+    /** True when the state verifiably changed (or was verified already-equal). */
+    ok: boolean;
+    /** Keys / stores / atoms / queries written. */
+    applied: number;
+    /** Items that could not be restored, with a reason each. */
+    skipped: {
+        id: string;
+        reason: string;
+    }[];
+    warnings: string[];
+}
+export interface StateSnapshotProvider {
+    /** Stable source id, e.g. "storage" | "redux" | "zustand" | "jotai" | "query". */
+    id: string;
+    /** Display name, e.g. "Storage", "React Query". */
+    label: string;
+    /** Cheap capability probe — drives UI gating and restore-mode suggestions. */
+    status(): StateSnapshotProviderStatus;
+    capture(): Promise<StateSnapshotCapture>;
+    restore(data: unknown): Promise<StateSnapshotRestoreResult>;
+    /**
+     * Optional: wipe this source to fresh-install state. Used by the
+     * "restore baseline" flow (typically followed by a JS reload so in-memory
+     * stores rebuild themselves from the wiped persisted state).
+     */
+    clear?(): Promise<StateSnapshotRestoreResult>;
+}
+type Listener = () => void;
+/**
+ * Register a provider. Last registration wins for a given id.
+ * Returns an unregister function (only removes the provider if it is still
+ * the registered one for that id).
+ */
+export declare function registerStateSnapshotProvider(provider: StateSnapshotProvider): () => void;
+export declare function getStateSnapshotProviders(): StateSnapshotProvider[];
+export declare function getStateSnapshotProvider(id: string): StateSnapshotProvider | null;
+/** Notifies when providers register/unregister (query registers late). */
+export declare function subscribeToStateSnapshotProviders(listener: Listener): () => void;
+export {};
+//# sourceMappingURL=stateSnapshotRegistry.d.ts.map

package/lib/typescript/module/utils/stateSnapshotRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateSnapshotRegistry.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateSnapshotRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,8EAA8E;IAC9E,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,IAAI,2BAA2B,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC5D;;;;OAIG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC/C;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAe3B;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CASZ;AAED,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CAEnE;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,GACT,qBAAqB,GAAG,IAAI,CAE9B;AAED,0EAA0E;AAC1E,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,QAAQ,GACjB,MAAM,IAAI,CAKZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/shared-ui",
-  "version": "7.0.16",
+  "version": "7.0.17",
   "description": "Shared UI components, hooks, and utilities",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -136,10 +136,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "^7.0.16"
+    "@buoy-gg/floating-tools-core": "^7.0.17"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "7.0.16",
+    "@buoy-gg/license": "7.0.17",
     "@react-native-clipboard/clipboard": "*",
     "expo-clipboard": "*",
     "expo-file-system": "*",
@@ -167,7 +167,7 @@
     "expo-clipboard": "~7.1.5",
     "react-native-safe-area-context": "^5.6.2",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "^7.0.16"
+    "@buoy-gg/license": "^7.0.17"
   },
   "react-native-builder-bob": {
     "source": "src",