@aiquants/contact-map 0.12.0 → 0.13.0

package/README.md

@@ -138,7 +138,9 @@ A 401 or 403 ends the load at once in phase `auth-required` with the error `Auth
 
 ```tsx
 // app/routes/contact_map.tsx
-import { ContactMapConfigProvider, ContactMapSearchPage } from "@aiquants/contact-map/client"
+import { ContactMapConfigProvider, ContactMapSearchPage, contactMapShouldRevalidate } from "@aiquants/contact-map/client"
+
+export const shouldRevalidate = contactMapShouldRevalidate
 
 export default function ContactMapRoute() {
     return (
@@ -154,6 +156,9 @@ export default function ContactMapRoute() {
 }
 ```
 
+Export `contactMapShouldRevalidate` as the route's `shouldRevalidate`. On the same path, a change of nothing but the page's own URL state (the list / tree tab `view` and the search term `q`) does not run the route's loader, since the records stream in on the client. Every other transition keeps React Router's decision (another path, another parameter, and the unchanged URL after an action, a `revalidate()` call or a link to the current page), so a loader that checks the session still runs then; a submission is decided by its URL the same way. It is built with `@aiquants/route-revalidation`.
+ルートの `shouldRevalidate` には `contactMapShouldRevalidate` を公開する。同じパスでページ自身の URL の状態 (一覧とツリーのタブ `view` と検索語 `q`) だけが変わる遷移では、ルートのローダーを走らせない (レコードはクライアントへストリームで届く)。ほかの遷移 (別のパス・ほかのパラメータ・アクションの後や `revalidate()`・今のページへのリンクのような URL の変わらない場合) は React Router の判断を保つので、セッションを確かめるローダーはそのときも走る。送信も URL で同じに決める。`@aiquants/route-revalidation` で組んでいる。
+
 The page needs its styles, which depend on the host: a host that builds with Tailwind CSS v4 generates the classes itself, and a host without it imports the standalone CSS (see Styling).
 ページにはスタイルが要り、その用意はホストによって変わる: Tailwind CSS v4 でビルドするホストは自分のビルドでクラスを生成し、Tailwind CSS を使わないホストはスタンドアロンの CSS を読み込む (スタイルの節を参照)。
 

package/dist/client.d.mts

@@ -8,6 +8,7 @@ import { VirtualScrollLocale } from "@aiquants/virtualscroll";
 import * as _aiquants_fuzzy_search from "@aiquants/fuzzy-search";
 import { UseFuzzySearchOptions as UseFuzzySearchOptions$1, UnifiedWorkerStats } from "@aiquants/fuzzy-search";
 import { R as ResponsiveThresholds, C as ContactMapDirectoryEntry, a as ContactRecordForTree, b as ContactMapTreeNaming } from "./tree-types-B9J5unS2.mjs";
+import * as _aiquants_route_revalidation from "@aiquants/route-revalidation";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 interface AdvancedSearchSettingsProps {
     searchOptions: UseFuzzySearchOptions;
@@ -709,7 +710,7 @@ declare const getTreeWorkerSession: (treeWorkerUrl?: string) => TreeWorkerSessio
 declare const resetTreeWorkerSessionForTesting: () => void;
 declare function useTreeWorker(records: readonly ContactRecordForTree[], isComplete?: boolean): TreeWorkerState;
 declare const useContactMapLabels: () => ContactMapLabels;
-declare function contactMapShouldRevalidate(): boolean;
+declare const contactMapShouldRevalidate: _aiquants_route_revalidation.RouteShouldRevalidate;
 type ProgressProps = react.ComponentPropsWithoutRef<"div"> & {
     value?: number;
     max?: number;

package/dist/client.d.ts

@@ -8,6 +8,7 @@ import { VirtualScrollLocale } from "@aiquants/virtualscroll";
 import * as _aiquants_fuzzy_search from "@aiquants/fuzzy-search";
 import { UseFuzzySearchOptions as UseFuzzySearchOptions$1, UnifiedWorkerStats } from "@aiquants/fuzzy-search";
 import { R as ResponsiveThresholds, C as ContactMapDirectoryEntry, a as ContactRecordForTree, b as ContactMapTreeNaming } from "./tree-types-B9J5unS2.js";
+import * as _aiquants_route_revalidation from "@aiquants/route-revalidation";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 interface AdvancedSearchSettingsProps {
     searchOptions: UseFuzzySearchOptions;
@@ -709,7 +710,7 @@ declare const getTreeWorkerSession: (treeWorkerUrl?: string) => TreeWorkerSessio
 declare const resetTreeWorkerSessionForTesting: () => void;
 declare function useTreeWorker(records: readonly ContactRecordForTree[], isComplete?: boolean): TreeWorkerState;
 declare const useContactMapLabels: () => ContactMapLabels;
-declare function contactMapShouldRevalidate(): boolean;
+declare const contactMapShouldRevalidate: _aiquants_route_revalidation.RouteShouldRevalidate;
 type ProgressProps = react.ComponentPropsWithoutRef<"div"> & {
     value?: number;
     max?: number;