totally-tubular 0.5.0 → 0.6.0

package/dist/react.d.ts

@@ -32,7 +32,7 @@ import type { AllObjectKeys, PropType } from './types.js';
  * }
  * ```
  */
-export declare function useTubular<T extends object, K extends string>(tubular: Tubular<T>, key: K & AllObjectKeys<T>): readonly [PropType<T, K> | null, (newValOrCallback: PropType<T, K> | ((prevVal: PropType<T, K> | null) => PropType<T, K>)) => void];
+export declare function useTubular<T extends object, K extends AllObjectKeys<T>>(tubular: Tubular<T>, key: K): readonly [PropType<T, K> | null, (newValOrCallback: PropType<T, K> | ((prevVal: PropType<T, K> | null) => PropType<T, K>)) => void];
 /**
  * Creates a hook bound to a specific {@link Tubular} instance, so you never
  * have to pass the instance around at every call site.
@@ -63,7 +63,7 @@ export declare function useTubular<T extends object, K extends string>(tubular:
  * }
  * ```
  */
-export declare function createUseTubular<T extends object>(tubular: Tubular<T>): <K extends string>(key: K & AllObjectKeys<T>) => readonly [PropType<T, K & AllObjectKeys<T>> | null, (newValOrCallback: PropType<T, K & AllObjectKeys<T>> | ((prevVal: PropType<T, K & AllObjectKeys<T>> | null) => PropType<T, K & AllObjectKeys<T>>)) => void];
+export declare function createUseTubular<T extends object>(tubular: Tubular<T>): <K extends AllObjectKeys<T>>(key: K) => readonly [PropType<T, K> | null, (newValOrCallback: PropType<T, K> | ((prevVal: PropType<T, K> | null) => PropType<T, K>)) => void];
 /**
  * A React hook that returns a stable callback to reset a {@link Tubular} store
  * back to its initial state.

package/dist/totally-tubular.d.ts

@@ -15,11 +15,11 @@ export declare class Tubular<T extends object> {
     /**
      * observe changes to some part of state that was updated
      */
-    observe<K extends string>(propPath: K & AllObjectKeys<T>, observeCallback: ObservationCallback<T>): void;
+    observe<K extends AllObjectKeys<T>>(propPath: K, observeCallback: ObservationCallback<T, K>): void;
     /**
      * reads a portion of your state
      */
-    read<K extends string>(readPath: K & AllObjectKeys<T>): PropType<T, K> | null;
+    read<K extends AllObjectKeys<T>>(readPath: K): PropType<T, K> | null;
     private resetImpl;
     /**
      * resets the state back to its initial value
@@ -29,9 +29,9 @@ export declare class Tubular<T extends object> {
     /**
      * disconnects an observer callback from totally tubular
      */
-    unobserve<K extends string>(propPath: K & AllObjectKeys<T>, observeCallback: ObservationCallback<T>): void;
+    unobserve<K extends AllObjectKeys<T>>(propPath: K, observeCallback: ObservationCallback<T, K>): void;
     /**
      * updates a portion of your state
      */
-    update<K extends string>(updatePath: K & AllObjectKeys<T>, valUpdater: (oldVal: PropType<T, K>) => PropType<T, K>): void;
+    update<K extends AllObjectKeys<T>>(updatePath: K, valUpdater: (oldVal: PropType<T, K>) => PropType<T, K>): void;
 }

package/dist/types.d.ts

@@ -41,13 +41,13 @@ export type PropType<T, P extends string> = P extends keyof T ? T[P] : P extends
 /**
  * Callback invoked by Tubular whenever an observed path changes.
  *
- * The previous definition used defaulted type parameters
- * (`K = AllObjectKeys<T>`, `V = PropType<T, K & string>`). Default type
- * parameters are eagerly evaluated by the checker at *every* reference to
- * `ObservationCallback<T>`, causing a full `AllObjectKeys<T>` + distributed
- * `PropType` expansion each time. Using `unknown` for the value parameters
- * defers any narrowing to call sites that actually need it, which is a far
- * smaller surface area.
+ * `K` is the dot-path being observed, and `newVal`/`oldVal` resolve to
+ * `PropType<T, K>` — the value type of exactly that path. `K` is a required
+ * type parameter with no default: defaulted parameters were eagerly expanded
+ * at *every* reference to `ObservationCallback<T>` (a full `AllObjectKeys<T>`
+ * + distributed `PropType` expansion each time). This form evaluates
+ * `PropType` once per call site, against the concrete literal key that
+ * `observe`/`unobserve` infer from the path argument.
  */
-export type ObservationCallback<T> = (newVal: unknown, oldVal: unknown, propPath: AllObjectKeys<T>) => void;
+export type ObservationCallback<T, K extends string> = (newVal: PropType<T, K>, oldVal: PropType<T, K>, propPath: K) => void;
 export {};

package/package.json

@@ -3,7 +3,7 @@
   "description": "A completely framework-agnostic, JavaScript / TypeScript state management and update broadcasting library wit zero dependencies, solid performance and a micro file size.",
   "name": "totally-tubular",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "keywords": [
     "state",
     "management",
@@ -26,6 +26,13 @@
   "files": [
     "dist/"
   ],
+  "scripts": {
+    "build": "rm -rf dist/ && tsc --project ./tsconfig.build.json",
+    "clean": "rm -rf dist/",
+    "test": "vitest test",
+    "test:performance": "tsx ./performanceTests.ts",
+    "test:watch": "vitest test --watch"
+  },
   "devDependencies": {
     "@better-builds/lets-version": "^1.6.0",
     "@biomejs/biome": "^2.4.16",
@@ -71,12 +78,5 @@
       "default": "./dist/types.js"
     },
     "./package.json": "./package.json"
-  },
-  "scripts": {
-    "build": "rm -rf dist/ && tsc --project ./tsconfig.build.json",
-    "clean": "rm -rf dist/",
-    "test": "vitest test",
-    "test:performance": "tsx ./performanceTests.ts",
-    "test:watch": "vitest test --watch"
   }
-}
+}