@usels/core 0.0.1

package/src/types.ts

@@ -0,0 +1,56 @@
+/**
+ * @usels/core - Utility functions for Legend-State
+ */
+
+import type { Observable } from "@legendapp/state";
+
+/**
+ * A value that can be either a raw value or an Observable
+ * Similar to VueUse's MaybeRef pattern
+ *
+ * @example
+ * ```ts
+ * const value: MaybeObservable<string> = 'hello'
+ * const obs: MaybeObservable<string> = observable('hello')
+ * ```
+ */
+export type MaybeObservable<T = any> = T | Observable<T>;
+
+/**
+ * Either the whole `T` can be an Observable, OR each individual property of `T` can be an Observable.
+ *
+ * Unlike `MaybeObservable<T>` which only wraps the outer object, `DeepMaybeObservable<T>` also
+ * allows every field to independently accept `Observable<FieldType>`.
+ *
+ * @example
+ * ```ts
+ * type Options = DeepMaybeObservable<{ count: number; label: string }>
+ * // All of these are valid:
+ * const a: Options = { count: 1, label: 'hi' }                           // plain object
+ * const b: Options = { count: observable(1), label: observable('hi') }   // per-field observables
+ * const c: Options = observable({ count: 1, label: 'hi' })               // whole object observable
+ * ```
+ */
+export type DeepMaybeObservable<T> = Observable<T> | {
+  [K in keyof T]?: MaybeObservable<NonNullable<T[K]>>;
+};
+
+// --- TIER 0-A: Base utility types (VueUse equivalents) ---
+
+export type Fn = () => void
+export type AnyFn = (...args: any[]) => any
+export type Arrayable<T> = T[] | T
+export type Awaitable<T> = Promise<T> | T
+export type TimerHandle = ReturnType<typeof setTimeout> | undefined
+
+export interface Pausable {
+  readonly isActive: Observable<boolean>
+  pause: Fn
+  resume: Fn
+}
+
+export interface Stoppable<StartFnArgs extends any[] = any[]> {
+  readonly isPending: Observable<boolean>
+  stop: Fn
+  start: (...args: StartFnArgs) => void
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "jsx": "react-jsx"
+  }
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/**/*.{ts,tsx}', '!src/**/*.spec.*'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  bundle: false,
+});

package/vitest.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    // Test files to include
+    include: ['src/**/*.spec.ts'],
+
+    // Test environment
+    environment: 'node',
+
+    // Global test APIs
+    globals: true,
+
+    // Coverage configuration specific to utils package
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      include: ['src/**/*.ts'],
+      exclude: ['src/**/*.spec.ts', 'src/index.ts'],
+    },
+  },
+});