@rangojs/router 0.0.0-experimental.112 → 0.0.0-experimental.113

package/src/use-loader.tsx

@@ -187,17 +187,20 @@ export interface UseLoaderOptions {
    */
   key?: string;
   /**
-   * Cross-loader refresh group. Tag reads of DIFFERENT loaders with the same
-   * `refreshGroup` name, then call `useRefreshLoaders(name)()` to refresh the
-   * whole group at once. Each member is refreshed with a plain GET against the
-   * current route URL — no params, no body, no mutation methods — because a
-   * group spans heterogeneous loaders with different param/return shapes.
+   * Cross-loader refresh group tag(s). Tag reads of DIFFERENT loaders with a
+   * shared name, then call `useRefreshLoaders()(name)` to refresh the whole group
+   * at once. Pass an array to tag one read into several groups — it is refreshed
+   * when ANY of its groups is refreshed, so a coarse tag can cover the whole set
+   * while a finer tag targets a subset. Each member is refreshed with a plain GET
+   * against the current route URL — no params, no body, no mutation methods —
+   * because a group spans heterogeneous loaders with different param/return
+   * shapes.
    *
    * For parameterized sharing of a SINGLE loader, use `key` instead; group
    * members should be registered or non-parameterized-keyed reads (a plain-GET
    * group refresh would drop any per-call params).
    */
-  refreshGroup?: string;
+  refreshGroup?: string | string[];
 }
 
 /**
@@ -254,29 +257,42 @@ function useLoaderInternal<T>(
   // only hooks with the same `key` refresh together. Default (no key) keeps the
   // historical behavior: one bucket per loader id.
   const key = options?.key;
-  const refreshGroup = options?.refreshGroup;
+  // Normalize the refresh-group tag(s) to a stable, deduped, sorted list. The
+  // joined `groupKey` string is the subscribe effect's dependency, so passing an
+  // inline array literal (`refreshGroup={["a", "b"]}`) does not force a
+  // resubscribe on every render. An empty list means "no groups" — identical to
+  // omitting the option (`hasGroups` stays false, no private bucket is created).
+  const refreshGroupOption = options?.refreshGroup;
+  const groupKey =
+    refreshGroupOption === undefined
+      ? ""
+      : JSON.stringify(
+          typeof refreshGroupOption === "string"
+            ? [refreshGroupOption]
+            : [...new Set(refreshGroupOption)].sort(),
+        );
+  const groupList = useMemo<string[]>(
+    () => (groupKey === "" ? [] : (JSON.parse(groupKey) as string[])),
+    [groupKey],
+  );
+  const hasGroups = groupList.length > 0;
   // A grouped reader with no explicit key gets a private per-hook bucket so a
   // cross-loader group refresh cannot leak into the bare `loader.$$id` bucket
   // shared by unrelated unkeyed readers. Sharing within a group is opt-in via
   // an explicit `key`.
   const privateBucketIdRef = useRef<string | null>(null);
-  if (
-    refreshGroup !== undefined &&
-    key === undefined &&
-    privateBucketIdRef.current === null
-  ) {
+  if (hasGroups && key === undefined && privateBucketIdRef.current === null) {
     privateBucketIdRef.current = `__rg${privateGroupBucketSeq++}`;
   }
   const effectiveKey =
-    key ??
-    (refreshGroup !== undefined ? privateBucketIdRef.current! : undefined);
+    key ?? (hasGroups ? privateBucketIdRef.current! : undefined);
   const bucketKey =
     effectiveKey === undefined ? loaderId : `${loaderId}::${effectiveKey}`;
 
   // Plain-GET refresh thunk registered with the store for cross-loader group
   // refresh (useRefreshLoaders). Always shares into this hook's bucket, never
   // touches lastSharedRequestIdRef (so a group refresh never render-throws —
-  // errors surface via `error` and reject the refreshGroup() promise instead),
+  // errors surface via `error` and reject the refreshGroups() promise instead),
   // and sends no params/body. Stable across navigations (depends only on
   // loaderId + bucketKey), so the store keeps one current thunk per bucket.
   const groupRefetch = useCallback(async (): Promise<void> => {
@@ -340,16 +356,17 @@ function useLoaderInternal<T>(
       {
         loaderId,
         ephemeral: !hasContextData,
-        group: refreshGroup,
-        refetch: refreshGroup !== undefined ? groupRefetch : undefined,
+        group: hasGroups ? groupList : undefined,
+        refetch: hasGroups ? groupRefetch : undefined,
       },
     );
     // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional:
     // sharedSnapshot is captured for the one-shot init sync; we don't want
     // to re-subscribe on every snapshot change. bucketKey, hasContextData,
-    // refreshGroup, and groupRefetch are the only inputs that require a fresh
-    // subscription (groupRefetch is stable per bucketKey).
-  }, [bucketKey, hasContextData, refreshGroup, groupRefetch]);
+    // groupKey, and groupRefetch are the only inputs that require a fresh
+    // subscription (groupList is memoized on groupKey; groupRefetch is stable
+    // per bucketKey).
+  }, [bucketKey, hasContextData, groupKey, groupRefetch]);
 
   // Local state holds the result of:
   //   - parameterized / mutation `load()` calls (load({ params }), POST,
@@ -360,9 +377,13 @@ function useLoaderInternal<T>(
   //     prevents two unrelated components from accidentally sharing data
   //     through the global store just because they reference the same
   //     loader id.
-  const [localFetchedData, setLocalFetchedData] = useState<T | undefined>(
-    undefined,
-  );
+  // `has` distinguishes a committed local result (including `null`/`undefined`)
+  // from "no local load yet", so a load() that resolves to a falsy value is not
+  // discarded in favor of the shared snapshot or the seeded context.
+  const [localFetchedData, setLocalFetchedData] = useState<{
+    has: boolean;
+    value: T | undefined;
+  }>({ has: false, value: undefined });
   const [localIsLoading, setLocalIsLoading] = useState(false);
   const [localError, setLocalError] = useState<Error | null>(null);
 
@@ -385,7 +406,7 @@ function useLoaderInternal<T>(
   const prevContextDataRef = useRef(contextData);
   useEffect(() => {
     if (prevContextDataRef.current !== contextData) {
-      setLocalFetchedData(undefined);
+      setLocalFetchedData({ has: false, value: undefined });
       setLocalIsLoading(false);
       setLocalError(null);
       lastSharedRequestIdRef.current = null;
@@ -396,10 +417,14 @@ function useLoaderInternal<T>(
     }
   }, [contextData, loaderId]);
 
-  // Read priority: a parameterized load() result overrides the shared
-  // snapshot; the shared snapshot overrides the server-seeded context.
-  const data =
-    localFetchedData ?? (sharedSnapshot.value as T | undefined) ?? contextData;
+  // Read priority: a committed parameterized load() result overrides the shared
+  // snapshot; a committed shared snapshot overrides the server-seeded context.
+  // `has`/`hasValue` gate each level so a committed falsy value is not skipped.
+  const data = localFetchedData.has
+    ? localFetchedData.value
+    : sharedSnapshot.hasValue
+      ? (sharedSnapshot.value as T | undefined)
+      : contextData;
   const isLoading = localIsLoading || sharedSnapshot.isLoading;
   const error = localError ?? sharedSnapshot.error;
 
@@ -553,7 +578,7 @@ function useLoaderInternal<T>(
           // if a newer load() was issued from this hook before this one
           // resolved, drop the stale result.
           startTransition(() => {
-            setLocalFetchedData(result);
+            setLocalFetchedData({ has: true, value: result });
             setLocalIsLoading(false);
           });
         }
@@ -712,14 +737,21 @@ export function useFetchLoader<T>(
 }
 
 /**
- * Refresh every loader tagged with a shared `refreshGroup` name.
+ * Get a stable function that refreshes loaders by cross-loader group tag.
  *
- * Returns a stable async function that refreshes all currently-mounted reads
- * in the group with a plain GET against the current route URL. This is the
- * cross-loader counterpart to the single-loader `key`: use it to refresh a set
- * of DIFFERENT loaders together (e.g. profile + orders after an account
- * switch). Members are tagged via `useLoader(Loader, { refreshGroup })` /
- * `useFetchLoader(Loader, { refreshGroup })`.
+ * The returned `refresh(groups)` takes one group name or an array of names and
+ * re-runs every currently-mounted read tagged with ANY of them, with a plain GET
+ * against the current route URL. This is the cross-loader counterpart to the
+ * single-loader `key`: use it to refresh a set of DIFFERENT loaders together
+ * (e.g. profile + orders after an account switch). Members are tagged via
+ * `useLoader(Loader, { refreshGroup })` / `useFetchLoader(Loader, { refreshGroup })`,
+ * where `refreshGroup` is one name or several.
+ *
+ * Passing the group(s) to the returned function rather than to the hook lets a
+ * single `useRefreshLoaders()` instance refresh different groups depending on
+ * context, and lets one call refresh several groups at once — their members are
+ * unioned and deduped, so a loader tagged into two of the named groups is fetched
+ * exactly once.
  *
  * Group refresh never render-throws: a failing member surfaces its error via
  * that read's `error` state, and the returned promise rejects with an
@@ -736,15 +768,30 @@ export function useFetchLoader<T>(
  *   return <span>{data.name}</span>;
  * }
  * function Orders() {
- *   const { data } = useLoader(OrdersLoader, { key: userId, refreshGroup: "account" });
+ *   // Tagged into two groups: refreshed by "account" (the whole set) or "orders".
+ *   const { data } = useLoader(OrdersLoader, {
+ *     key: userId,
+ *     refreshGroup: ["account", "orders"],
+ *   });
  *   return <span>{data.count} orders</span>;
  * }
- * function RefreshButton() {
- *   const refreshAccount = useRefreshLoaders("account");
- *   return <button onClick={() => refreshAccount()}>Refresh</button>;
+ * function RefreshButtons() {
+ *   const refresh = useRefreshLoaders();
+ *   return (
+ *     <>
+ *       <button onClick={() => refresh("account")}>Refresh account</button>
+ *       <button onClick={() => refresh("orders")}>Refresh orders</button>
+ *       <button onClick={() => refresh(["account", "orders"])}>Refresh both</button>
+ *     </>
+ *   );
  * }
  * ```
  */
-export function useRefreshLoaders(group: string): () => Promise<void> {
-  return useCallback(() => loaderStore.refreshGroup(group), [group]);
+export function useRefreshLoaders(): (
+  groups: string | string[],
+) => Promise<void> {
+  return useCallback(
+    (groups: string | string[]) => loaderStore.refreshGroups(groups),
+    [],
+  );
 }

package/src/vite/plugins/use-cache-transform.ts

@@ -30,6 +30,13 @@ const CACHE_RUNTIME_IMPORT = "@rangojs/router/cache-runtime";
 // and should not be wrapped (children can't be cache-keyed).
 const LAYOUT_TEMPLATE_PATTERN = /\/(layout|template)\.(tsx?|jsx?)$/;
 
+/**
+ * Grammar for a valid function-level directive: `use cache` optionally followed
+ * by `: <profile-name>`. The single source of truth for both the transform and
+ * the near-miss validator below.
+ */
+export const USE_CACHE_DIRECTIVE_RE: RegExp = /^use cache(:\s*[\w-]+)?$/;
+
 export function useCacheTransform(): Plugin {
   let projectRoot = "";
   let isBuild = false;
@@ -116,9 +123,9 @@ export function useCacheTransform(): Plugin {
           transformHoistInlineDirective,
         );
 
-        // Always check for near-miss directives, even when valid directives
-        // exist. A file may contain both valid and invalid "use cache" directives
-        // in different functions — the invalid ones should still warn.
+        // Check for near-miss directives on the function-level path. The
+        // file-level branch above returns earlier (it wraps every export
+        // regardless), so this runs only when there is no file-level directive.
         warnOnNearMissDirectives(ast, id, this.warn.bind(this));
 
         if (functionResult) return functionResult;
@@ -219,7 +226,7 @@ function transformFunctionLevelUseCache(
 ) {
   try {
     const { output, names } = transformHoistInlineDirective(code, ast, {
-      directive: /^use cache(:\s*[\w-]+)?$/,
+      directive: USE_CACHE_DIRECTIVE_RE,
       runtime: (
         value: string,
         name: string,
@@ -273,11 +280,6 @@ function findFileLevelDirective(
   return null;
 }
 
-/**
- * The valid directive regex (must stay in sync with transformFunctionLevelUseCache).
- */
-const VALID_DIRECTIVE_RE = /^use cache(:\s*[\w-]+)?$/;
-
 /**
  * Regex for near-miss: starts with "use cache:" but has invalid tokens.
  */
@@ -307,7 +309,7 @@ function warnOnNearMissDirectives(
       if (
         value.startsWith("use cache") &&
         NEAR_MISS_RE.test(value) &&
-        !VALID_DIRECTIVE_RE.test(value)
+        !USE_CACHE_DIRECTIVE_RE.test(value)
       ) {
         const profilePart = value.slice("use cache:".length).trim();
         warn(

package/dist/__internal.d.ts

@@ -1,83 +0,0 @@
-/**
- * Internal Types - Implementation Details
- *
- * @internal
- * These types are for internal use only and should not be relied upon by consumers.
- * They may change without notice between versions.
- *
- * If you find yourself needing these types, please open an issue to discuss
- * adding them to the public API.
- */
-/**
- * @internal
- * Internal representation of a resolved route segment.
- * Used during route matching and rendering pipeline.
- */
-export type { ResolvedSegment, SegmentMetadata } from "./types.js";
-/**
- * @internal
- * Internal match result from route resolution.
- */
-export type { MatchResult, SlotState } from "./types.js";
-/**
- * @internal
- * Context for intercept route selection.
- */
-export type { InterceptSelectorContext, InterceptSegmentsState, InterceptWhenFn, } from "./server/context.js";
-/**
- * @internal
- * RSC protocol payload structure.
- */
-export type { RscPayload, ReactFormState } from "./rsc/types.js";
-/**
- * @internal
- * Internal navigation store interface.
- */
-export type { NavigationStore, NavigationBridge, RscMetadata, ActionResult, InflightAction, NavigationState, TrackedActionState, ActionStateListener, SegmentCache, SegmentState, NavigationUpdate, } from "./browser/types.js";
-/**
- * @internal
- * Internal handle storage mechanism.
- */
-export type { HandleStore, HandleData } from "./server/handle-store.js";
-/**
- * @internal
- * Segment handle data in cache.
- */
-export type { SegmentHandleData } from "./cache/types.js";
-/**
- * @internal
- * Internal cache entry data structure.
- */
-export type { CachedEntryData, CachedEntryResult, CacheGetResult, SerializedSegmentData, CacheDefaults, } from "./cache/types.js";
-/**
- * @internal
- * Router context for AsyncLocalStorage.
- */
-export type { RouterContext, RevalidationContext, InterceptResult } from "./router/router-context.js";
-/**
- * @internal
- * Route match context during pipeline processing.
- */
-export type { MatchContext, MatchPipelineState } from "./router/match-context.js";
-/**
- * @internal
- * Pattern matching result.
- */
-export type { RouteMatchResult } from "./router/pattern-matching.js";
-/**
- * @internal
- * Entry data during route traversal.
- */
-export type { EntryData, InterceptEntry, MetricsStore, PerformanceMetric, EntryCacheConfig, EntryPropCommon, EntryPropDatas, LoaderEntry, EntryPropSegments, } from "./server/context.js";
-/**
- * @internal
- * Internal handler context with additional props for router internals.
- * Includes `_originalRequest` and `_currentSegmentId`.
- */
-export type { InternalHandlerContext } from "./types.js";
-/**
- * @internal
- * Debug utilities for manifest inspection and comparison.
- */
-export { serializeManifest, compareManifests, formatManifestDiff, type SerializedEntry, type SerializedManifest, } from "./debug.js";
-//# sourceMappingURL=__internal.d.ts.map

package/dist/__internal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"__internal.d.ts","sourceRoot":"","sources":["../src/__internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMzD;;;GAGG;AACH,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAM7B;;;GAGG;AACH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;GAGG;AACH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAM5B;;;GAGG;AACH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;GAGG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D;;;GAGG;AACH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMtG;;;GAGG;AACH,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;GAGG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMrE;;;GAGG;AACH,YAAY,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B;;;;GAIG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMzD;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}

package/dist/__internal.js

@@ -1,19 +0,0 @@
-/**
- * Internal Types - Implementation Details
- *
- * @internal
- * These types are for internal use only and should not be relied upon by consumers.
- * They may change without notice between versions.
- *
- * If you find yourself needing these types, please open an issue to discuss
- * adding them to the public API.
- */
-// ============================================================================
-// Debug Utilities (Internal)
-// ============================================================================
-/**
- * @internal
- * Debug utilities for manifest inspection and comparison.
- */
-export { serializeManifest, compareManifests, formatManifestDiff, } from "./debug.js";
-//# sourceMappingURL=__internal.js.map

package/dist/__internal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__internal.js","sourceRoot":"","sources":["../src/__internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsJH,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,YAAY,CAAC"}

package/dist/__mocks__/version.d.ts

@@ -1,7 +0,0 @@
-/**
- * Mock for rsc-router:version virtual module.
- * Used by vitest since the virtual module is only available at build time.
- * Empty string disables version path in URLs for simpler test assertions.
- */
-export declare const VERSION = "";
-//# sourceMappingURL=version.d.ts.map

package/dist/__mocks__/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/__mocks__/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,OAAO,KAAK,CAAC"}

package/dist/__mocks__/version.js

@@ -1,7 +0,0 @@
-/**
- * Mock for rsc-router:version virtual module.
- * Used by vitest since the virtual module is only available at build time.
- * Empty string disables version path in URLs for simpler test assertions.
- */
-export const VERSION = "";
-//# sourceMappingURL=version.js.map

package/dist/__mocks__/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/__mocks__/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,CAAC"}

package/dist/__tests__/client-href.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=client-href.test.d.ts.map

package/dist/__tests__/client-href.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-href.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client-href.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/client-href.test.js

@@ -1,74 +0,0 @@
-import { describe, it, expect, expectTypeOf } from "vitest";
-import { href } from "../href-client.js";
-describe("href()", () => {
-    describe("without mount", () => {
-        it("returns path unchanged", () => {
-            expect(href("/foo")).toBe("/foo");
-        });
-        it("handles root path", () => {
-            expect(href("/")).toBe("/");
-        });
-        it("handles nested paths", () => {
-            expect(href("/blog/my-post")).toBe("/blog/my-post");
-        });
-        it("handles paths with query strings", () => {
-            expect(href("/search?q=test")).toBe("/search?q=test");
-        });
-        it("handles paths with hash fragments", () => {
-            expect(href("/about#contact")).toBe("/about#contact");
-        });
-        it("handles paths with query and hash", () => {
-            expect(href("/page?a=1#top")).toBe("/page?a=1#top");
-        });
-    });
-    describe("with mount", () => {
-        it("prepends mount to path", () => {
-            expect(href("/foo", "/articles")).toBe("/articles/foo");
-        });
-        it("prepends mount to root path", () => {
-            expect(href("/", "/articles")).toBe("/articles/");
-        });
-        it("handles nested mount", () => {
-            expect(href("/detail", "/articles/comments")).toBe("/articles/comments/detail");
-        });
-        it("treats root mount as no mount", () => {
-            expect(href("/foo", "/")).toBe("/foo");
-        });
-        it("handles undefined mount", () => {
-            expect(href("/foo", undefined)).toBe("/foo");
-        });
-        it("handles empty string mount", () => {
-            expect(href("/foo", "")).toBe("/foo");
-        });
-    });
-    describe("PatternToPath types", () => {
-        it("static path", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-        it("dynamic param", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-        it("optional param at end", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-        it("constrained param", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-        it("multiple dynamic params", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-        it("root path stays root", () => {
-            expectTypeOf().toEqualTypeOf();
-        });
-    });
-    describe("ValidPaths fallback", () => {
-        // When no routes are registered, ValidPaths falls back to `/${string}`
-        // This is tested implicitly by the fact that href() accepts any path starting with /
-        it("accepts any path when no routes registered", () => {
-            // href() is callable with any /-prefixed string
-            const result = href("/anything/at/all");
-            expect(result).toBe("/anything/at/all");
-        });
-    });
-});
-//# sourceMappingURL=client-href.test.js.map

package/dist/__tests__/client-href.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-href.test.js","sourceRoot":"","sources":["../../src/__tests__/client-href.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/component-utils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=component-utils.test.d.ts.map

package/dist/__tests__/component-utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/component-utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/component-utils.test.js

@@ -1,51 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { isClientComponent, assertClientComponent } from "../component-utils";
-describe("component-utils", () => {
-    describe("isClientComponent", () => {
-        it("should return false for regular functions", () => {
-            const ServerComponent = () => null;
-            expect(isClientComponent(ServerComponent)).toBe(false);
-        });
-        it("should return false for non-functions", () => {
-            expect(isClientComponent(null)).toBe(false);
-            expect(isClientComponent(undefined)).toBe(false);
-            expect(isClientComponent("string")).toBe(false);
-            expect(isClientComponent(123)).toBe(false);
-            expect(isClientComponent({})).toBe(false);
-        });
-        it("should return true for functions with client reference marker", () => {
-            const ClientComponent = () => null;
-            // Simulate what the bundler does for "use client" components
-            ClientComponent.$$typeof = Symbol.for("react.client.reference");
-            ClientComponent.$$id = "src/components/MyComponent.tsx#default";
-            expect(isClientComponent(ClientComponent)).toBe(true);
-        });
-        it("should return false for functions with wrong $$typeof symbol", () => {
-            const Component = () => null;
-            Component.$$typeof = Symbol.for("react.element");
-            expect(isClientComponent(Component)).toBe(false);
-        });
-    });
-    describe("assertClientComponent", () => {
-        it("should throw for non-function values", () => {
-            expect(() => assertClientComponent(null, "document")).toThrow('document must be a client component function with "use client" directive');
-            expect(() => assertClientComponent({}, "document")).toThrow('document must be a client component function with "use client" directive');
-        });
-        it("should throw for server components (no client marker)", () => {
-            const ServerComponent = () => null;
-            expect(() => assertClientComponent(ServerComponent, "document")).toThrow('document must be a client component with "use client" directive');
-            expect(() => assertClientComponent(ServerComponent, "document")).toThrow("cannot be serialized in the RSC payload");
-        });
-        it("should not throw for client components", () => {
-            const ClientComponent = () => null;
-            ClientComponent.$$typeof = Symbol.for("react.client.reference");
-            ClientComponent.$$id = "src/document.tsx#default";
-            expect(() => assertClientComponent(ClientComponent, "document")).not.toThrow();
-        });
-        it("should include component name in error message", () => {
-            const ServerComponent = () => null;
-            expect(() => assertClientComponent(ServerComponent, "myLayout")).toThrow("myLayout must be a client component");
-        });
-    });
-});
-//# sourceMappingURL=component-utils.test.js.map

package/dist/__tests__/component-utils.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-utils.test.js","sourceRoot":"","sources":["../../src/__tests__/component-utils.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/event-controller.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=event-controller.test.d.ts.map

package/dist/__tests__/event-controller.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-controller.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/event-controller.test.ts"],"names":[],"mappings":""}