@buoy-gg/shared-ui 7.0.41 → 7.0.42

package/lib/commonjs/utils/subscribable.js

@@ -1,113 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Subscribable = void 0;
-/**
- * Subscribable - Base class for pub/sub pattern with lifecycle hooks
- *
- * Ported from TanStack Query's subscription architecture.
- * Provides a foundation for self-managing listeners that automatically
- * start when the first subscriber joins and stop when the last leaves.
- *
- * @example
- * ```typescript
- * class NetworkEventStore extends Subscribable<NetworkEventListener> {
- *   protected onSubscribe(): void {
- *     if (this.listeners.size === 1) {
- *       // First subscriber - start listening
- *       this.startNetworkListener();
- *     }
- *   }
- *
- *   protected onUnsubscribe(): void {
- *     if (this.listeners.size === 0) {
- *       // Last subscriber left - stop listening
- *       this.stopNetworkListener();
- *     }
- *   }
- * }
- * ```
- */
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-
-class Subscribable {
-  listeners = new Set();
-  constructor() {
-    this.subscribe = this.subscribe.bind(this);
-  }
-
-  /**
-   * Subscribe to updates.
-   * @param listener - Callback function to receive updates
-   * @returns Unsubscribe function
-   */
-  subscribe(listener) {
-    this.listeners.add(listener);
-    this.onSubscribe();
-    return () => {
-      this.listeners.delete(listener);
-      this.onUnsubscribe();
-    };
-  }
-
-  /**
-   * Check if there are any active listeners.
-   */
-  hasListeners() {
-    return this.listeners.size > 0;
-  }
-
-  /**
-   * Get the current number of listeners.
-   */
-  getListenerCount() {
-    return this.listeners.size;
-  }
-
-  /**
-   * Notify all listeners with given arguments.
-   */
-  notify(...args) {
-    this.listeners.forEach(listener => {
-      listener(...args);
-    });
-  }
-
-  /**
-   * Called when a listener is added.
-   * Override to start resources when first subscriber joins.
-   *
-   * @example
-   * ```typescript
-   * protected onSubscribe(): void {
-   *   if (this.listeners.size === 1) {
-   *     this.startCapturing();
-   *   }
-   * }
-   * ```
-   */
-  onSubscribe() {
-    // Override in subclasses
-  }
-
-  /**
-   * Called when a listener is removed.
-   * Override to stop resources when last subscriber leaves.
-   *
-   * @example
-   * ```typescript
-   * protected onUnsubscribe(): void {
-   *   if (this.listeners.size === 0) {
-   *     this.stopCapturing();
-   *   }
-   * }
-   * ```
-   */
-  onUnsubscribe() {
-    // Override in subclasses
-  }
-}
-exports.Subscribable = Subscribable;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.Subscribable=void 0;class Subscribable{listeners=new Set;constructor(){this.subscribe=this.subscribe.bind(this)}subscribe(s){this.listeners.add(s);this.onSubscribe();return()=>{this.listeners.delete(s);this.onUnsubscribe()}}hasListeners(){return this.listeners.size>0}getListenerCount(){return this.listeners.size}notify(...s){this.listeners.forEach(e=>{e(...s)})}onSubscribe(){}onUnsubscribe(){}}exports.Subscribable=Subscribable;

package/lib/commonjs/utils/subscriberCountNotifier.js

@@ -1,72 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.subscriberCountNotifier = exports.subscribeToSubscriberCountChanges = exports.notifySubscriberCountChange = void 0;
-/**
- * Subscriber Count Notifier
- *
- * Global notification system for subscriber count changes across all event stores.
- * Follows TanStack Query's pattern where stores notify when observers are added/removed,
- * allowing UI to update instantly instead of polling.
- *
- * This is in shared-ui to avoid circular dependencies between packages.
- *
- * Usage in event stores:
- * ```typescript
- * import { notifySubscriberCountChange } from '@buoy-gg/shared-ui';
- *
- * protected onSubscribe(): void {
- *   // ... existing logic
- *   notifySubscriberCountChange('storage');
- * }
- * ```
- *
- * Usage in UI:
- * ```typescript
- * useEffect(() => {
- *   return subscribeToSubscriberCountChanges(() => {
- *     // Refresh subscriber counts
- *   });
- * }, []);
- * ```
- */
-
-class SubscriberCountNotifier {
-  listeners = new Set();
-
-  /**
-   * Subscribe to subscriber count changes.
-   * Called whenever any event store's subscriber count changes.
-   */
-  subscribe(listener) {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  }
-
-  /**
-   * Notify all listeners that a store's subscriber count changed.
-   * Called by event stores in their onSubscribe/onUnsubscribe hooks.
-   */
-  notify(sourceId) {
-    this.listeners.forEach(listener => {
-      try {
-        listener(sourceId);
-      } catch {
-        // Ignore listener errors
-      }
-    });
-  }
-}
-
-// Singleton instance
-const subscriberCountNotifier = exports.subscriberCountNotifier = new SubscriberCountNotifier();
-
-// Convenience exports
-const subscribeToSubscriberCountChanges = listener => subscriberCountNotifier.subscribe(listener);
-exports.subscribeToSubscriberCountChanges = subscribeToSubscriberCountChanges;
-const notifySubscriberCountChange = sourceId => subscriberCountNotifier.notify(sourceId);
-exports.notifySubscriberCountChange = notifySubscriberCountChange;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.subscriberCountNotifier=exports.subscribeToSubscriberCountChanges=exports.notifySubscriberCountChange=void 0;class SubscriberCountNotifier{listeners=new Set;subscribe(s){this.listeners.add(s);return()=>{this.listeners.delete(s)}}notify(s){this.listeners.forEach(r=>{try{r(s)}catch{}})}}const subscriberCountNotifier=exports.subscriberCountNotifier=new SubscriberCountNotifier;const subscribeToSubscriberCountChanges=e=>subscriberCountNotifier.subscribe(e);exports.subscribeToSubscriberCountChanges=subscribeToSubscriberCountChanges;const notifySubscriberCountChange=e=>subscriberCountNotifier.notify(e);exports.notifySubscriberCountChange=notifySubscriberCountChange;

package/lib/commonjs/utils/time/RelativeTime.js

@@ -1,31 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.RelativeTime = RelativeTime;
-var _reactNative = require("react-native");
-var _useRelativeTime = require("./useRelativeTime.js");
-var _jsxRuntime = require("react/jsx-runtime");
-/**
- * Leaf component that renders a live relative timestamp ("5s ago").
- *
- * Composition-over-memo (rule2): list rows should render THIS instead of
- * calling `useRelativeTime` themselves — the shared TickProvider tick then
- * re-renders only this Text, not the whole (often memoized) row and its
- * icon subtree. Profiling on the Network tool (tool-bench 2026-07-06)
- * showed the tick accounted for ~half of all row re-renders before this
- * isolation.
- */
-function RelativeTime({
-  timestamp,
-  style,
-  prefix = "",
-  suffix = ""
-}) {
-  const relative = (0, _useRelativeTime.useRelativeTime)(timestamp);
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
-    style: style,
-    children: [prefix, relative, suffix]
-  });
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.RelativeTime=RelativeTime;var _reactNative=require("react-native");var _useRelativeTime=require("./useRelativeTime.js");var _jsxRuntime=require("react/jsx-runtime");function RelativeTime({timestamp:e,style:t,prefix:r="",suffix:i=""}){const a=(0,_useRelativeTime.useRelativeTime)(e);return(0,_jsxRuntime.jsxs)(_reactNative.Text,{style:t,children:[r,a,i]})}

package/lib/commonjs/utils/time/TickContext.js

@@ -1,43 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.TickProvider = TickProvider;
-exports.useTick = useTick;
-var _react = require("react");
-var _jsxRuntime = require("react/jsx-runtime");
-const TickContext = /*#__PURE__*/(0, _react.createContext)(null);
-/**
- * Provides a shared clock tick to all descendants.
- * Wrap each devtools modal/screen in a single TickProvider so that all list items
- * share one timer instead of each item creating its own interval.
- *
- * Only mounted (visible) items consume the context, so FlatList virtualization
- * ensures off-screen items don't re-render.
- */
-function TickProvider({
-  children,
-  intervalMs = 5_000
-}) {
-  const [tick, setTick] = (0, _react.useState)(() => Date.now());
-  (0, _react.useEffect)(() => {
-    const id = setInterval(() => {
-      setTick(Date.now());
-    }, intervalMs);
-    return () => {
-      clearInterval(id);
-    };
-  }, [intervalMs]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(TickContext.Provider, {
-    value: tick,
-    children: children
-  });
-}
-
-/**
- * Returns the current tick from the nearest TickProvider, or null if none exists.
- */
-function useTick() {
-  return (0, _react.useContext)(TickContext);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.TickProvider=TickProvider;exports.useTick=useTick;var _react=require("react");var _jsxRuntime=require("react/jsx-runtime");const TickContext=(0,_react.createContext)(null);function TickProvider({children:t,intervalMs:e=5e3}){const[r,c]=(0,_react.useState)(()=>Date.now());(0,_react.useEffect)(()=>{const n=setInterval(()=>{c(Date.now())},e);return()=>{clearInterval(n)}},[e]);return(0,_jsxRuntime.jsx)(TickContext.Provider,{value:r,children:t})}function useTick(){return(0,_react.useContext)(TickContext)}

package/lib/commonjs/utils/time/formatRelativeTime.js

@@ -1,34 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.formatRelativeTime = formatRelativeTime;
-/**
- * Formats a timestamp as relative time (e.g., "1s ago", "5m ago", "2h ago")
- * @param timestamp - The timestamp to format (Date object or number in milliseconds)
- * @param currentTime - Current time in milliseconds (defaults to Date.now())
- * @returns Formatted relative time string
- */
-function formatRelativeTime(timestamp, currentTime = Date.now()) {
-  const timestampMs = timestamp instanceof Date ? timestamp.getTime() : timestamp;
-  const seconds = Math.floor((currentTime - timestampMs) / 1000);
-
-  // Handle edge cases
-  if (seconds < 0) {
-    return "just now";
-  }
-  if (seconds < 60) {
-    return seconds === 0 ? "just now" : `${seconds}s ago`;
-  }
-  const minutes = Math.floor(seconds / 60);
-  if (minutes < 60) {
-    return `${minutes}m ago`;
-  }
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24) {
-    return `${hours}h ago`;
-  }
-  const days = Math.floor(hours / 24);
-  return `${days}d ago`;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.formatRelativeTime=formatRelativeTime;function formatRelativeTime(o,n=Date.now()){const s=o instanceof Date?o.getTime():o;const t=Math.floor((n-s)/1e3);if(t<0){return"just now"}if(t<60){return t===0?"just now":`${t}s ago`}const e=Math.floor(t/60);if(e<60){return`${e}m ago`}const r=Math.floor(e/60);if(r<24){return`${r}h ago`}const a=Math.floor(r/24);return`${a}d ago`}

package/lib/commonjs/utils/time/index.js

@@ -1,39 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "RelativeTime", {
-  enumerable: true,
-  get: function () {
-    return _RelativeTime.RelativeTime;
-  }
-});
-Object.defineProperty(exports, "TickProvider", {
-  enumerable: true,
-  get: function () {
-    return _TickContext.TickProvider;
-  }
-});
-Object.defineProperty(exports, "formatRelativeTime", {
-  enumerable: true,
-  get: function () {
-    return _formatRelativeTime.formatRelativeTime;
-  }
-});
-Object.defineProperty(exports, "useRelativeTime", {
-  enumerable: true,
-  get: function () {
-    return _useRelativeTime.useRelativeTime;
-  }
-});
-Object.defineProperty(exports, "useTick", {
-  enumerable: true,
-  get: function () {
-    return _TickContext.useTick;
-  }
-});
-var _formatRelativeTime = require("./formatRelativeTime.js");
-var _useRelativeTime = require("./useRelativeTime.js");
-var _RelativeTime = require("./RelativeTime.js");
-var _TickContext = require("./TickContext.js");
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"RelativeTime",{enumerable:true,get:function(){return _RelativeTime.RelativeTime}});Object.defineProperty(exports,"TickProvider",{enumerable:true,get:function(){return _TickContext.TickProvider}});Object.defineProperty(exports,"formatRelativeTime",{enumerable:true,get:function(){return _formatRelativeTime.formatRelativeTime}});Object.defineProperty(exports,"useRelativeTime",{enumerable:true,get:function(){return _useRelativeTime.useRelativeTime}});Object.defineProperty(exports,"useTick",{enumerable:true,get:function(){return _TickContext.useTick}});var _formatRelativeTime=require("./formatRelativeTime.js");var _useRelativeTime=require("./useRelativeTime.js");var _RelativeTime=require("./RelativeTime.js");var _TickContext=require("./TickContext.js");

package/lib/commonjs/utils/time/useRelativeTime.js

@@ -1,36 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useRelativeTime = useRelativeTime;
-var _react = require("react");
-var _formatRelativeTime = require("./formatRelativeTime.js");
-var _TickContext = require("./TickContext.js");
-/**
- * Hook that returns a live-updating relative time string (e.g., "5s ago", "2m ago").
- *
- * When inside a `<TickProvider>`, uses the shared tick — no per-item timer.
- * When used standalone (no provider), falls back to its own interval.
- *
- * @param timestamp - The timestamp to format (Date, number in ms, or nullish)
- * @returns Formatted relative time string, or empty string if no timestamp
- */
-function useRelativeTime(timestamp) {
-  const contextTick = (0, _TickContext.useTick)();
-  const hasProvider = contextTick !== null;
-  const [fallbackNow, setFallbackNow] = (0, _react.useState)(() => Date.now());
-  const timestampMs = timestamp ? timestamp instanceof Date ? timestamp.getTime() : timestamp : 0;
-
-  // Only run a per-item interval when there's no TickProvider
-  (0, _react.useEffect)(() => {
-    if (hasProvider || !timestampMs) return;
-    const id = setInterval(() => {
-      setFallbackNow(Date.now());
-    }, 5_000);
-    return () => clearInterval(id);
-  }, [hasProvider, timestampMs]);
-  if (!timestampMs) return "";
-  const now = hasProvider ? contextTick : fallbackNow;
-  return (0, _formatRelativeTime.formatRelativeTime)(timestampMs, now);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useRelativeTime=useRelativeTime;var _react=require("react");var _formatRelativeTime=require("./formatRelativeTime.js");var _TickContext=require("./TickContext.js");function useRelativeTime(e){const a=(0,_TickContext.useTick)();const r=a!==null;const[i,n]=(0,_react.useState)(()=>Date.now());const t=e?e instanceof Date?e.getTime():e:0;(0,_react.useEffect)(()=>{if(r||!t)return;const c=setInterval(()=>{n(Date.now())},5e3);return()=>clearInterval(c)},[r,t]);if(!t)return"";const o=r?a:i;return(0,_formatRelativeTime.formatRelativeTime)(t,o)}

package/lib/commonjs/utils/toolModules.js

@@ -1,25 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getRegisteredToolModule = getRegisteredToolModule;
-exports.getToolModuleVersion = getToolModuleVersion;
-exports.registerToolModules = registerToolModules;
-const modules = new Map();
-let version = 0;
-function registerToolModules(input) {
-  for (const [id, module] of Object.entries(input)) {
-    const name = id.startsWith('@buoy-gg/') ? id.replace(/\/web$/, '') : `@buoy-gg/${id}`;
-    if (modules.get(name) !== module) {
-      modules.set(name, module);
-      version++;
-    }
-  }
-}
-function getRegisteredToolModule(name) {
-  return modules.get(name) ?? null;
-}
-function getToolModuleVersion() {
-  return version;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getRegisteredToolModule=getRegisteredToolModule;exports.getToolModuleVersion=getToolModuleVersion;exports.registerToolModules=registerToolModules;const modules=new Map;let version=0;function registerToolModules(e){for(const[o,t]of Object.entries(e)){const r=o.startsWith("@buoy-gg/")?o.replace(/\/web$/,""):`@buoy-gg/${o}`;if(modules.get(r)!==t){modules.set(r,t);version++}}}function getRegisteredToolModule(e){return modules.get(e)??null}function getToolModuleVersion(){return version}

package/lib/commonjs/utils/typeHelpers.js

@@ -1,142 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isValidJson = exports.isPrimitive = exports.isPlainObject = exports.isJsonSerializable = exports.isEmpty = exports.getValueType = exports.getValueSize = exports.getConstructorName = void 0;
-/**
- * Type detection and validation utilities
- */
-
-/**
- * Detects the type of a value with more granular type checking
- * @param value - The value to check
- * @returns A string representing the specific type
- */
-const getValueType = value => {
-  if (value === null) return "null";
-  if (value === undefined) return "undefined";
-  if (Array.isArray(value)) return "array";
-  const type = typeof value;
-  if (type === "object") {
-    // Check for specific object types
-    if (value instanceof Date) return "date";
-    if (value instanceof RegExp) return "regexp";
-    if (value instanceof Map) return "map";
-    if (value instanceof Set) return "set";
-    if (value instanceof Error) return "error";
-    return "object";
-  }
-  return type;
-};
-
-/**
- * Checks if a value is a primitive type
- * @param value - The value to check
- * @returns True if the value is primitive
- */
-exports.getValueType = getValueType;
-const isPrimitive = value => {
-  const type = typeof value;
-  return value === null || value === undefined || type === "string" || type === "number" || type === "boolean" || type === "bigint" || type === "symbol";
-};
-
-/**
- * Checks if a value is a valid JSON serializable value
- * @param value - The value to check
- * @returns True if the value can be JSON serialized
- */
-exports.isPrimitive = isPrimitive;
-const isJsonSerializable = value => {
-  try {
-    JSON.stringify(value);
-    return true;
-  } catch {
-    return false;
-  }
-};
-
-/**
- * Checks if a string represents a valid JSON value
- * @param str - The string to test
- * @returns True if the string is valid JSON
- */
-exports.isJsonSerializable = isJsonSerializable;
-const isValidJson = str => {
-  try {
-    JSON.parse(str);
-    return true;
-  } catch {
-    return false;
-  }
-};
-
-/**
- * Safely gets the constructor name of a value
- * @param value - The value to check
- * @returns The constructor name or type string
- */
-exports.isValidJson = isValidJson;
-const getConstructorName = value => {
-  if (value === null) return "null";
-  if (value === undefined) return "undefined";
-  try {
-    return value.constructor?.name || typeof value;
-  } catch {
-    return typeof value;
-  }
-};
-
-/**
- * Checks if a value is an empty object or array
- * @param value - The value to check
- * @returns True if the value is empty
- */
-exports.getConstructorName = getConstructorName;
-const isEmpty = value => {
-  if (value === null || value === undefined) return true;
-  if (typeof value === "string") return value.length === 0;
-  if (Array.isArray(value)) return value.length === 0;
-  if (typeof value === "object") return Object.keys(value).length === 0;
-  return false;
-};
-
-/**
- * Gets a human-readable size description for objects and arrays
- * @param value - The value to get size for
- * @returns A human-readable size string
- */
-exports.isEmpty = isEmpty;
-const getValueSize = value => {
-  if (Array.isArray(value)) {
-    const count = value.length;
-    if (count === 0) return "empty array";
-    if (count === 1) return "1 item";
-    return `${count} items`;
-  }
-  if (value && typeof value === "object") {
-    const keys = Object.keys(value);
-    const count = keys.length;
-    if (count === 0) return "empty object";
-    if (count === 1) return "1 key";
-    return `${count} keys`;
-  }
-  if (typeof value === "string") {
-    const length = value.length;
-    if (length === 0) return "empty string";
-    if (length === 1) return "1 character";
-    return `${length} characters`;
-  }
-  return "";
-};
-
-/**
- * Type guard to check if a value is an object (not null, not array)
- * @param value - The value to check
- * @returns True if value is a plain object
- */
-exports.getValueSize = getValueSize;
-const isPlainObject = value => {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && value.constructor === Object;
-};
-exports.isPlainObject = isPlainObject;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.isValidJson=exports.isPrimitive=exports.isPlainObject=exports.isJsonSerializable=exports.isEmpty=exports.getValueType=exports.getValueSize=exports.getConstructorName=void 0;const getValueType=t=>{if(t===null)return"null";if(t===void 0)return"undefined";if(Array.isArray(t))return"array";const r=typeof t;if(r==="object"){if(t instanceof Date)return"date";if(t instanceof RegExp)return"regexp";if(t instanceof Map)return"map";if(t instanceof Set)return"set";if(t instanceof Error)return"error";return"object"}return r};exports.getValueType=getValueType;const isPrimitive=t=>{const r=typeof t;return t===null||t===void 0||r==="string"||r==="number"||r==="boolean"||r==="bigint"||r==="symbol"};exports.isPrimitive=isPrimitive;const isJsonSerializable=t=>{try{JSON.stringify(t);return true}catch{return false}};exports.isJsonSerializable=isJsonSerializable;const isValidJson=t=>{try{JSON.parse(t);return true}catch{return false}};exports.isValidJson=isValidJson;const getConstructorName=t=>{if(t===null)return"null";if(t===void 0)return"undefined";try{return t.constructor?.name||typeof t}catch{return typeof t}};exports.getConstructorName=getConstructorName;const isEmpty=t=>{if(t===null||t===void 0)return true;if(typeof t==="string")return t.length===0;if(Array.isArray(t))return t.length===0;if(typeof t==="object")return Object.keys(t).length===0;return false};exports.isEmpty=isEmpty;const getValueSize=t=>{if(Array.isArray(t)){const r=t.length;if(r===0)return"empty array";if(r===1)return"1 item";return`${r} items`}if(t&&typeof t==="object"){const r=Object.keys(t);const e=r.length;if(e===0)return"empty object";if(e===1)return"1 key";return`${e} keys`}if(typeof t==="string"){const r=t.length;if(r===0)return"empty string";if(r===1)return"1 character";return`${r} characters`}return""};exports.getValueSize=getValueSize;const isPlainObject=t=>{return typeof t==="object"&&t!==null&&!Array.isArray(t)&&t.constructor===Object};exports.isPlainObject=isPlainObject;