@stacksjs/browser 0.70.23 → 0.70.25

package/dist/src/composables/index.d.ts

@@ -0,0 +1,140 @@
+export * from './useAuth';
+export * from './useApi';
+// Re-export browser-relevant composables from @stacksjs/composables
+export {
+  // Color mode / Theme
+  useColorMode,
+  useDark,
+  usePreferredColorScheme,
+  usePreferredContrast,
+  usePreferredDark,
+  usePreferredReducedMotion,
+
+  // Date / Time
+  useDateFormat,
+  useNow,
+  useTimeAgo,
+  useTimestamp,
+
+  // Network / Online
+  useFetch,
+  useNetwork,
+  useOnline,
+
+  // Storage
+  useLocalStorage,
+  useSessionStorage,
+  useStorage,
+
+  // Toggle / State
+  useToggle,
+  useCounter,
+  useStepper,
+  useCycleList,
+
+  // DOM / Elements
+  useActiveElement,
+  useClipboard,
+  useClipboardItems,
+  useCssVar,
+  useDocumentVisibility,
+  useElementBounding,
+  useElementHover,
+  useElementSize,
+  useElementVisibility,
+  useFocus,
+  useFocusWithin,
+  useFullscreen,
+  useScroll,
+  useScrollLock,
+  useTitle,
+  useWindowFocus,
+  useWindowScroll,
+  useWindowSize,
+
+  // Events / Interaction
+  onClickOutside,
+  onKeyDown,
+  onKeyStroke,
+  onKeyUp,
+  onLongPress,
+  onStartTyping,
+  useEventListener,
+  useKeyModifier,
+  useMagicKeys,
+
+  // Mouse / Pointer / Swipe
+  useDraggable,
+  useDropZone,
+  useMouse,
+  useMouseInElement,
+  useMousePressed,
+  usePointer,
+  usePointerSwipe,
+  useSwipe,
+
+  // Sensors
+  useBattery,
+  useDeviceMotion,
+  useDeviceOrientation,
+  useDevicePixelRatio,
+  useGeolocation,
+
+  // Media
+  useBreakpoints,
+  useMediaQuery,
+  breakpointsTailwind,
+  breakpointsBootstrapV5,
+
+  // Page / Navigation
+  useBrowserLocation,
+  useIdle,
+  useInfiniteScroll,
+  useNavigatorLanguage,
+  usePageLeave,
+  usePreferredLanguages,
+  useScreenOrientation,
+  useTextDirection,
+  useTextSelection,
+  useUrlSearchParams,
+
+  // Timing
+  useDebounceFn,
+  useInterval,
+  useIntervalFn,
+  useRafFn,
+  useThrottleFn,
+  useTimeout,
+  useTimeoutFn,
+  useTimeoutPoll,
+
+  // Animations
+  useAnimate,
+  useTransition,
+  TransitionPresets,
+
+  // APIs
+  useBase64,
+  useBroadcastChannel,
+  useConfirmDialog,
+  useEventBus,
+  useEventSource,
+  useEyeDropper,
+  useFavicon,
+  useFileDialog,
+  useImage,
+  useObjectUrl,
+  usePermission,
+  useShare,
+  useVibrate,
+  useWakeLock,
+  useWebNotification,
+  useWebSocket,
+  useWebWorker,
+  useWebWorkerFn,
+
+  // Utilities
+  useSupported,
+  useMemoize,
+  useMounted,
+} from '@stacksjs/composables';

package/dist/src/composables/useApi.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Initialize the API client with custom configuration
+ *
+ * NOTE: This is now OPTIONAL. The framework auto-initializes with
+ * sensible defaults when @stacksjs/browser is imported.
+ *
+ * Only call this if you need custom configuration:
+ * - Different API base URL
+ * - Custom unauthorized handler
+ * - Custom token retrieval
+ *
+ * @example
+ * // Custom base URL
+ * initApi({ baseUrl: 'https://api.example.com' })
+ *
+ * @example
+ * // Custom unauthorized handler
+ * initApi({
+ *   onUnauthorized: () => showLoginModal()
+ * })
+ */
+export declare function initApi(options?: {
+  baseUrl?: string
+  onUnauthorized?: () => void
+}): void;
+/**
+ * Helper to format area size for display
+ */
+export declare function formatAreaSize(sqMeters: number): string;
+/**
+ * Helper to format distance for display
+ */
+export declare function formatDistance(miles: number): string;
+/**
+ * Helper to format elevation for display
+ */
+export declare function formatElevation(feet: number): string;
+/**
+ * Helper to format duration for display
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Helper to get relative time (e.g., "2 hours ago")
+ */
+export declare function getRelativeTime(dateString: string): string;
+/**
+ * Type-safe API fetch wrapper with error handling
+ */
+export declare function fetchData<T>(fetcher: () => Promise<T>, options?: {
+    onError?: (error: Error) => void
+    fallback?: T
+  }): Promise<T | undefined>;
+/**
+ * Auth utilities
+ */
+export declare const auth: unknown;

package/dist/src/composables/useAuth.d.ts

@@ -0,0 +1,6 @@
+import type { AuthComposable } from '../types/dashboard';
+export declare function useAuth(): AuthComposable;
+// Strict auth guard middleware
+// Usage: call in setup() of page/component, or in router beforeEach
+// Pass { guest: true } for guest-only pages
+export declare function authGuard(options?: { guest?: boolean }): void;

package/dist/src/index.d.ts

@@ -0,0 +1,32 @@
+import './auto-init';
+export type {
+  BrowserModelDefinition,
+  BrowserTypedAttribute,
+  BrowserModelInstance,
+  BrowserModelQueryBuilder,
+} from 'bun-query-builder/browser';
+// `BrowserConfig` lives in the main `bun-query-builder` types entry, not the
+// `/browser` subpath — re-export it from there. The runtime code in this file
+// uses only the `/browser` entry, so server-only code paths are still avoided.
+export type { BrowserConfig } from 'bun-query-builder';
+export * from './composables';
+export * from './utils';
+export * from './model-loader';
+// Re-export browser query builder from bun-query-builder.
+//
+// Pull from the dedicated `/browser` subpath instead of the main entry —
+// the main entry pulls in `bun:sqlite`, `child_process`, `stream/promises`,
+// etc. through server-side code branches, which the browser bundler can't
+// elide. The package's own `./browser` export is purpose-built for this:
+// only browser-safe code, no Node/Bun builtins.
+export {
+  browserQuery,
+  BrowserQueryBuilder,
+  BrowserQueryError,
+  browserAuth,
+  configureBrowser,
+  getBrowserConfig,
+  createBrowserDb,
+  createBrowserModel,
+  isBrowser,
+} from 'bun-query-builder/browser';

package/dist/src/model-loader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Load all models and register them on window.StacksBrowser
+ */
+export declare function loadBrowserModels(): void;
+/**
+ * Get a loaded model by name
+ */
+export declare function getBrowserModel(name: string): any;
+/**
+ * Get all loaded model names
+ */
+export declare function getBrowserModelNames(): string[];

package/dist/src/utils/base.d.ts

@@ -0,0 +1,7 @@
+// export function assert(condition: boolean, message: string): asserts condition {
+//   if (!condition)
+//     throw new Error(message)
+// }
+// export function noop() {}
+export declare function loop(times: number, callback: any): Promise<void>;
+export { toString } from '@stacksjs/strings';

package/dist/{billable.d.ts → src/utils/billable.d.ts}

@@ -1,7 +1,7 @@
-export declare let publishableKey: string;
 export declare function loadCardElement(clientSecret: string): Promise<any>;
 export declare function loadPaymentElement(clientSecret: string): Promise<any>;
 export declare function confirmCardSetup(clientSecret: string, elements: any): Promise<{ setupIntent: any, error: any }>;
 export declare function confirmCardPayment(clientSecret: string, elements: any): Promise<{ paymentIntent: any, error: any }>;
 export declare function createPaymentMethod(elements: any): Promise<{ paymentIntent: any, error: any }>;
-export declare function confirmPayment(elements: any): Promise<{ paymentIntent: any, error: any }>;
+export declare function confirmPayment(elements: any): Promise<{ paymentIntent: any, error: any }>;
+export declare const publishableKey: string;

package/dist/src/utils/date.d.ts

@@ -0,0 +1,2 @@
+export { useDateFormat, useNow } from '@stacksjs/composables';
+export { format, parse } from '@stacksjs/datetime';

package/dist/src/utils/debounce.d.ts

@@ -0,0 +1,5 @@
+export declare function debounce<T extends (..._args: any[]) => any>(fn: T, wait?: number, options?: DebounceOptions): T & { cancel: () => void, flush: () => void };
+export declare interface DebounceOptions {
+  leading?: boolean
+  trailing?: boolean
+}

package/dist/src/utils/fetch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Loose payload type for `Fetch.{get,post,patch,put,destroy}`.
+ *
+ * GET sends this as a query string; POST/PATCH/PUT send it as a JSON body.
+ * Values are constrained to JSON-serializable primitives + nested
+ * arrays/objects so we catch unintentional `Function` / `Date` / `Symbol`
+ * payloads at the call site instead of seeing them silently coerced
+ * to `[object Object]` over the wire.
+ */
+declare type Primitive = string | number | boolean | null | undefined;
+declare type FetchResponse = string | Blob | ArrayBuffer | ReadableStream<Uint8Array> | object;

package/dist/src/utils/function.d.ts

@@ -0,0 +1,18 @@
+import type { Fn, Nullable } from '@stacksjs/types';
+/**
+ * Call every function in an array
+ */
+export declare function batchInvoke(functions: Nullable<Fn>[]): void;
+/**
+ * Pass the value through the callback, and return the value
+ *
+ * @example
+ * ```
+ * function createUser(name: string): User {
+ *   return tap(new User, user => {
+ *     user.name = name
+ *   })
+ * }
+ * ```
+ */
+export declare function tap<T>(value: T, callback: (value: T) => void): T;

package/dist/src/utils/guards.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Type guard to filter out null-ish values
+ *
+ * @category Guards
+ * @example array.filter(notNullish)
+ */
+export declare function notNullish<T>(v: T | null | undefined): v is NonNullable<T>;
+/**
+ * Type guard to filter out null values
+ *
+ * @category Guards
+ * @example array.filter(noNull)
+ */
+export declare function noNull<T>(v: T | null): v is Exclude<T, null>;
+/**
+ * Type guard to filter out null-ish values
+ *
+ * @category Guards
+ * @example array.filter(notUndefined)
+ */
+export declare function notUndefined<T>(v: T): v is Exclude<T, undefined>;
+/**
+ * Type guard to filter out falsy values
+ *
+ * @category Guards
+ * @example array.filter(isTruthy)
+ */
+export declare function isTruthy<T>(v: T): v is NonNullable<T>;

package/dist/src/utils/index.d.ts

@@ -0,0 +1,17 @@
+export * from './base';
+export * from './billable';
+export * from './date';
+export * from './debounce';
+export * from './fetch';
+export * from './function';
+export * from './guards';
+export * from './lazy';
+export * from './math';
+export * from './plans';
+export * from './promise';
+export * from './random';
+export * from './regex';
+export * from './retry';
+export * from './sleep';
+export * from './throttle';
+export * from './vendors';

package/dist/src/utils/lazy.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lazily evaluate a value.
+ * @param getter A function that returns the value to be lazily evaluated.
+ * @returns An object with a `value` property that contains the lazily evaluated value.
+ */
+export declare function lazy<T>(getter: () => T): { value: T };

package/dist/{math.d.ts → src/utils/math.d.ts}

@@ -1,10 +1,8 @@
-export declare const clamp: n;
 export declare function rand(min: number, max: number): number;
-
+export declare const clamp: (n: number, min: number, max: number) => number;
+// Re-export reactive math utilities from @stacksjs/composables
 export {
   and,
-  createGenericProjection,
-  createProjection,
   logicNot,
   logicOr,
   or,
@@ -13,12 +11,10 @@ export {
   useCeil,
   useClamp,
   useFloor,
-  useMath,
   useMax,
   useMin,
   usePrecision,
-  useProjection,
   useRound,
   useSum,
   useTrunc,
-} from '@vueuse/math'
+} from '@stacksjs/composables';

package/dist/src/utils/plans.d.ts

@@ -0,0 +1,2 @@
+import type { SaasOption } from '@stacksjs/types';
+export declare const saas: SaasOption;

package/dist/src/utils/promise.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Create singleton promise function.
+ *
+ * @category Promise
+ */
+export declare function createSingletonPromise<T>(fn: () => Promise<T>): SingletonPromiseReturn<T>;
+/**
+ * Create a promise lock.
+ *
+ * @category Promise
+ * @example
+ * ```
+ * const lock = createPromiseLock()
+ *
+ * lock.run(async () => {
+ *   await doSomething()
+ * })
+ *
+ * // in anther context:
+ * await lock.wait() // it will wait all tasking finished
+ * ```
+ */
+export declare function createPromiseLock(): void;
+/**
+ * Return a Promise with `resolve` and `reject` methods
+ *
+ * @category Promise
+ * @example
+ * ```
+ * const promise = createControlledPromise()
+ *
+ * await promise
+ *
+ * // in anther context:
+ * promise.resolve(data)
+ * ```
+ */
+export declare function createControlledPromise<T>(): ControlledPromise<T>;
+export declare interface SingletonPromiseReturn<T> {
+  (): Promise<T>
+  reset: () => Promise<void>
+}
+/**
+ * Promise with `resolve` and `reject` methods of itself
+ */
+export declare interface ControlledPromise<T = void> extends Promise<T> {
+  resolve: (value: T | PromiseLike<T>) => void
+  reject: (reason?: any) => void
+}

package/dist/src/utils/random.d.ts

@@ -0,0 +1,10 @@
+declare function customRandom(alphabet: string, defaultSize: number, getRandom: (bytes: number) => Uint8Array): void;
+declare function customAlphabet(alphabet: string, size?: number): (size?: number) => string;
+declare function randomNonSecure(size?: number): string;
+declare function random(size?: number): string;
+export {
+  customAlphabet,
+  customRandom,
+  random,
+  randomNonSecure,
+};

package/dist/src/utils/regex.d.ts

@@ -0,0 +1,38 @@
+export type {
+  Flag,
+  Input,
+  MagicRegExp,
+  MagicRegExpMatchArray,
+  MapToStringCapturedBy,
+  StringCapturedBy,
+} from 'magic-regexp';
+// export function caseInsensitive(pattern: string): RegExp {
+//   return new RegExp(pattern, 'i')
+// }
+export declare function createRegExp(pattern: string, options?: { flags?: string }): RegExp;
+export {
+  anyOf,
+  carriageReturn,
+  caseInsensitive,
+  char,
+  charIn,
+  charNotIn,
+  digit,
+  dotAll,
+  exactly,
+  global,
+  letter,
+  linefeed,
+  maybe,
+  multiline,
+  not,
+  oneOrMore,
+  sticky,
+  tab,
+  unicode,
+  whitespace,
+  withIndices,
+  word,
+  wordBoundary,
+  wordChar,
+} from 'magic-regexp';

package/dist/{retry.d.ts → src/utils/retry.d.ts}

@@ -1,8 +1,10 @@
+// Replace the generic Function type with a more specific function type
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export declare function calculateDelay(attemptCount: number, initialDelay: number, backoffFactor: number, jitter?: boolean): number;
+// Define a more specific RetryOptions interface
 export declare interface RetryOptions {
   retries?: number
   initialDelay?: number
   backoffFactor?: number
   jitter?: boolean
 }
-export declare function retry<T>(fn: ()): Promise<T>;
-export declare function calculateDelay(attemptCount: number, initialDelay: number, backoffFactor: number, jitter?: boolean): number;

package/dist/src/utils/sleep.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export declare function wait(ms: number): Promise<void>;
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Pauses execution until a specified condition is met.
+ */
+export declare function waitUntil(condition: () => boolean, options?: WaitOptions): Promise<void>;
+/**
+ * Pauses execution while a specified condition is met.
+ */
+export declare function waitWhile(condition: () => boolean, options?: WaitOptions): Promise<void>;
+export type NonNegativeInteger<T extends number> = number extends T
+  ? never
+  : `${T}` extends `-${string}` | `${string}.${string}`
+    ? never
+    : T;
+export type WaitOptions = number | {
+  interval?: number
+  timeout?: number
+}

package/dist/src/utils/throttle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Throttle a function.
+ *
+ * @param {Function} fn - The function to throttle.
+ * @param {number} [wait] - The time to wait between function calls.
+ * @returns {Function} - A new function that throttles the calls to the original function.
+ *
+ * @example
+ * ```ts
+ * // logs window dimensions at most every 250ms
+ * window.addEventListener(
+ *   "resize",
+ *   throttle(function (evt) {
+ *     console.log(window.innerWidth)
+ *     console.log(window.innerHeight)
+ *   }, 250)
+ * )
+ * ```
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, wait?: number): (...args: Parameters<T>) => void;

package/dist/src/utils/vendors.d.ts

@@ -0,0 +1,29 @@
+export type {
+  HeadConfig as HeadObject,
+  HeadConfig as HeadObjectPlain,
+} from '@stacksjs/stx';
+export declare function readableSize(bytes: number, options?: ReadableSizeOptions): string;
+export declare interface ReadableSizeOptions {
+  precision?: number
+  binary?: boolean
+  space?: boolean
+  locale?: string
+  minimumFractionDigits?: number
+  maximumFractionDigits?: number
+}
+// Re-export composables from @stacksjs/composables
+export {
+  useDark,
+  useDateFormat,
+  useFetch,
+  useNow,
+  useOnline,
+  usePreferredDark,
+  useStorage,
+  useToggle,
+} from '@stacksjs/composables';
+export {
+  useHead as createHead,
+  useHead as Head,
+  renderHead as renderHeadToString,
+} from '@stacksjs/stx';

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@stacksjs/browser",
   "type": "module",
-  "version": "0.70.23",
+  "version": "0.70.25",
   "description": "Stacks core frontend/browser functionalities.",
   "author": "Chris Breuer",
-  "contributors": ["Chris Breuer <chris@stacksjs.org>"],
+  "contributors": [
+    "Chris Breuer <chris@stacksjs.com>"
+  ],
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
   "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/browser#readme",
@@ -16,25 +18,43 @@
   "bugs": {
     "url": "https://github.com/stacksjs/stacks/issues"
   },
-  "keywords": ["frontend", "browser", "stacks", "api"],
+  "keywords": [
+    "frontend",
+    "browser",
+    "stacks",
+    "api"
+  ],
   "exports": {
     ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./*": {
+      "bun": "./src/*",
       "import": "./dist/*"
     }
   },
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["README.md", "dist"],
+  "files": [
+    "README.md",
+    "dist"
+  ],
   "scripts": {
     "build": "bun build.ts",
     "typecheck": "bun tsc --noEmit",
     "prepublishOnly": "bun run build"
   },
+  "dependencies": {
+    "@stacksjs/composables": "0.70.23",
+    "@stacksjs/stx": "^0.2.40",
+    "@stripe/stripe-js": "^9.0.0",
+    "bun-query-builder": "^0.1.18",
+    "magic-regexp": "^0.11.0"
+  },
   "devDependencies": {
-    "@stacksjs/development": "0.70.22",
-    "@stacksjs/utils": "0.70.22"
+    "better-dx": "^0.2.12",
+    "@stacksjs/utils": "0.70.23"
   }
 }

package/dist/base.d.ts

@@ -1,3 +0,0 @@
-export declare function loop(times: number, callback: any): Promise<void>;
-
-export { toString } from '@stacksjs/strings'

package/dist/date.d.ts

@@ -1 +0,0 @@
-export * from '@stacksjs/datetime'

package/dist/debounce.d.ts

@@ -1 +0,0 @@
-export { debounce } from 'perfect-debounce'