@epoch32/visage 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/dist/api/client.d.ts +5 -0
  2. package/dist/api/file-router.d.ts +29 -0
  3. package/dist/api/handler.d.ts +15 -0
  4. package/dist/api/index.d.ts +12 -0
  5. package/dist/{src/api → api}/index.js +87 -2
  6. package/dist/api/middleware.d.ts +11 -0
  7. package/dist/api/pragma.d.ts +21 -0
  8. package/dist/api/procedure.d.ts +66 -0
  9. package/dist/api/types.d.ts +181 -0
  10. package/dist/charts/Area.d.ts +18 -0
  11. package/dist/charts/Axis.d.ts +21 -0
  12. package/dist/charts/Bar.d.ts +10 -0
  13. package/dist/charts/CartesianGrid.d.ts +10 -0
  14. package/dist/charts/Chart.d.ts +16 -0
  15. package/dist/charts/Cursor.d.ts +8 -0
  16. package/dist/charts/Legend.d.ts +9 -0
  17. package/dist/charts/Line.d.ts +18 -0
  18. package/dist/charts/Pie.d.ts +12 -0
  19. package/dist/charts/Tooltip.d.ts +12 -0
  20. package/dist/charts/context.d.ts +20 -0
  21. package/dist/charts/index.d.ts +14 -0
  22. package/dist/{src/charts → charts}/index.js +87 -2
  23. package/dist/charts/path.d.ts +27 -0
  24. package/dist/charts/scale.d.ts +23 -0
  25. package/dist/charts/types.d.ts +43 -0
  26. package/dist/devtools/DomTab.d.ts +6 -0
  27. package/dist/devtools/GraphInspector.d.ts +11 -0
  28. package/dist/devtools/GraphTab.d.ts +10 -0
  29. package/dist/devtools/QueryTab.d.ts +10 -0
  30. package/dist/devtools/RpcTab.d.ts +10 -0
  31. package/dist/devtools/SignalsTab.d.ts +10 -0
  32. package/dist/devtools/component.d.ts +2 -0
  33. package/dist/devtools/highlighter.d.ts +2 -0
  34. package/dist/devtools/hub.d.ts +41 -0
  35. package/dist/devtools/index.d.ts +9 -0
  36. package/dist/{src/devtools → devtools}/index.js +87 -2
  37. package/dist/devtools/styles.d.ts +1 -0
  38. package/dist/devtools/types.d.ts +44 -0
  39. package/dist/dom/async.d.ts +41 -0
  40. package/dist/dom/control-flow.d.ts +53 -0
  41. package/dist/dom/index.d.ts +3 -0
  42. package/dist/{src/dom → dom}/index.js +87 -2
  43. package/dist/dom/lazy.d.ts +30 -0
  44. package/dist/dom/render.d.ts +23 -0
  45. package/dist/dom/resource.d.ts +34 -0
  46. package/dist/form/form.d.ts +41 -0
  47. package/dist/form/index.d.ts +2 -0
  48. package/dist/{src/form → form}/index.js +87 -2
  49. package/dist/form/schema.d.ts +96 -0
  50. package/dist/index.d.ts +15 -0
  51. package/dist/{src/index.js → index.js} +87 -2
  52. package/dist/jsx-dev-runtime/index.d.ts +1 -0
  53. package/dist/jsx-runtime/index.d.ts +8 -0
  54. package/dist/{src/jsx-runtime → jsx-runtime}/index.js +87 -2
  55. package/dist/jsx-runtime/jsx.d.ts +278 -0
  56. package/dist/query/create-mutation.d.ts +3 -0
  57. package/dist/query/create-query.d.ts +4 -0
  58. package/dist/query/focus-manager.d.ts +14 -0
  59. package/dist/query/index.d.ts +9 -0
  60. package/dist/{src/query → query}/index.js +87 -2
  61. package/dist/query/mutation-cache.d.ts +24 -0
  62. package/dist/query/online-manager.d.ts +14 -0
  63. package/dist/query/query-cache.d.ts +69 -0
  64. package/dist/query/query-client.d.ts +46 -0
  65. package/dist/query/types.d.ts +131 -0
  66. package/dist/query/utils.d.ts +16 -0
  67. package/dist/router/index.d.ts +1 -0
  68. package/dist/{src/router → router}/index.js +87 -2
  69. package/dist/router/router.d.ts +91 -0
  70. package/dist/rpc/client.d.ts +2 -0
  71. package/dist/rpc/error.d.ts +16 -0
  72. package/dist/rpc/index.d.ts +7 -0
  73. package/dist/{src/rpc → rpc}/index.js +87 -2
  74. package/dist/rpc/procedure.d.ts +8 -0
  75. package/dist/rpc/router.d.ts +19 -0
  76. package/dist/rpc/server.d.ts +3 -0
  77. package/dist/rpc/types.d.ts +200 -0
  78. package/dist/server/hydrate.d.ts +5 -0
  79. package/dist/server/index.d.ts +3 -0
  80. package/dist/{src/server → server}/index.js +87 -2
  81. package/dist/server/render-to-stream.d.ts +9 -0
  82. package/dist/server/render-to-string.d.ts +6 -0
  83. package/dist/signals/computed.d.ts +61 -0
  84. package/dist/signals/context.d.ts +44 -0
  85. package/dist/signals/effect.d.ts +56 -0
  86. package/dist/signals/index.d.ts +8 -0
  87. package/dist/{src/signals → signals}/index.js +87 -2
  88. package/dist/signals/scope.d.ts +61 -0
  89. package/dist/signals/signal.d.ts +40 -0
  90. package/dist/signals/store.d.ts +45 -0
  91. package/dist/signals/system.d.ts +56 -0
  92. package/dist/signals/types.d.ts +58 -0
  93. package/dist/style/component.d.ts +49 -0
  94. package/dist/style/create-style.d.ts +63 -0
  95. package/dist/style/cx.d.ts +18 -0
  96. package/dist/style/hash.d.ts +8 -0
  97. package/dist/style/index.d.ts +8 -0
  98. package/dist/{src/style → style}/index.js +87 -2
  99. package/dist/style/layout.d.ts +129 -0
  100. package/dist/style/manager.d.ts +31 -0
  101. package/dist/style/parser.d.ts +12 -0
  102. package/dist/style/scale.d.ts +82 -0
  103. package/dist/template/index.d.ts +1 -0
  104. package/dist/{src/template → template}/index.js +87 -2
  105. package/dist/template/template.d.ts +8 -0
  106. package/dist/ui/accordion.d.ts +81 -0
  107. package/dist/ui/command-dialog.d.ts +10 -0
  108. package/dist/ui/command.d.ts +103 -0
  109. package/dist/ui/data-table.d.ts +38 -0
  110. package/dist/ui/dialog.d.ts +102 -0
  111. package/dist/ui/dropdown-menu.d.ts +92 -0
  112. package/dist/ui/icon.d.ts +18 -0
  113. package/dist/ui/index.d.ts +14 -0
  114. package/dist/{src/ui → ui}/index.js +87 -2
  115. package/dist/ui/layout.d.ts +1 -0
  116. package/dist/ui/popover.d.ts +68 -0
  117. package/dist/ui/switch.d.ts +31 -0
  118. package/dist/ui/tabs.d.ts +71 -0
  119. package/dist/ui/toast.d.ts +91 -0
  120. package/dist/ui/tooltip.d.ts +64 -0
  121. package/dist/ui/utils.d.ts +21 -0
  122. package/dist/virtual/index.d.ts +2 -0
  123. package/dist/{src/virtual → virtual}/index.js +87 -2
  124. package/dist/virtual/virtual-list.d.ts +21 -0
  125. package/dist/virtual/virtualizer.d.ts +31 -0
  126. package/dist/vite/hmr.d.ts +7 -0
  127. package/dist/vite/index.d.ts +3 -0
  128. package/dist/{src/vite → vite}/index.js +4 -0
  129. package/dist/vite/lucide.d.ts +27 -0
  130. package/dist/vite/plugin.d.ts +3 -0
  131. package/dist/vite/rpc-middleware.d.ts +5 -0
  132. package/dist/vite/types.d.ts +59 -0
  133. package/package.json +40 -40
  134. package/src/signals/index.ts +1 -0
  135. package/src/signals/signal.ts +110 -2
  136. package/src/signals/types.ts +9 -0
  137. package/src/vite/plugin.ts +4 -0
@@ -0,0 +1,46 @@
1
+ import type { Child } from "../dom/render";
2
+ import { type Context } from "../signals/context";
3
+ import { MutationCache } from "./mutation-cache";
4
+ import { QueryCache } from "./query-cache";
5
+ import type { DefaultOptions, QueryFilters, QueryKey, QueryOptions, QueryState } from "./types";
6
+ export interface QueryClientConfig {
7
+ defaultOptions?: DefaultOptions;
8
+ queryCache?: QueryCache;
9
+ mutationCache?: MutationCache;
10
+ }
11
+ export declare class QueryClient {
12
+ queryCache: QueryCache;
13
+ mutationCache: MutationCache;
14
+ defaultOptions: DefaultOptions;
15
+ private _unsubscribeFocus?;
16
+ private _unsubscribeOnline?;
17
+ private _isMounted;
18
+ constructor(config?: QueryClientConfig);
19
+ mount(): void;
20
+ unmount(): void;
21
+ private onWindowFocus;
22
+ private onOnline;
23
+ getDefaultOptions(): DefaultOptions;
24
+ setDefaultOptions(options: DefaultOptions): void;
25
+ getQueryCache(): QueryCache;
26
+ getMutationCache(): MutationCache;
27
+ getQueryData<TData = unknown>(queryKey: QueryKey): TData | undefined;
28
+ setQueryData<TData = unknown>(queryKey: QueryKey, updater: TData | ((prev: TData | undefined) => TData), options?: {
29
+ updatedAt?: number;
30
+ }): TData;
31
+ getQueryState<TData = unknown, TError = any>(queryKey: QueryKey): QueryState<TData, TError> | undefined;
32
+ fetchQuery<TData = unknown, TError = any>(options: QueryOptions<TData, TError, any>): Promise<TData>;
33
+ prefetchQuery<TData = unknown, TError = any>(options: QueryOptions<TData, TError, any>): Promise<void>;
34
+ invalidateQueries(filters?: QueryFilters): Promise<void>;
35
+ refetchQueries(filters?: QueryFilters): Promise<void>;
36
+ cancelQueries(filters?: QueryFilters): void;
37
+ removeQueries(filters?: QueryFilters): void;
38
+ resetQueries(filters?: QueryFilters): Promise<void>;
39
+ clear(): void;
40
+ }
41
+ export declare const QueryClientContext: Context<QueryClient | null>;
42
+ export declare function QueryClientProvider(props: {
43
+ client: QueryClient;
44
+ children: Child;
45
+ }): any;
46
+ export declare function useQueryClient(client?: QueryClient): QueryClient;
@@ -0,0 +1,131 @@
1
+ import type { ReadonlySignal } from "../signals";
2
+ export type QueryKey = readonly unknown[];
3
+ export interface QueryFunctionContext<TQueryKey extends QueryKey = QueryKey, TPageParam = any> {
4
+ queryKey: TQueryKey;
5
+ signal: AbortSignal;
6
+ pageParam?: TPageParam;
7
+ meta?: Record<string, unknown>;
8
+ }
9
+ export type QueryFunction<TData = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = any> = (context: QueryFunctionContext<TQueryKey, TPageParam>) => Promise<TData> | TData;
10
+ export type QueryStatus = "pending" | "success" | "error";
11
+ export type FetchStatus = "fetching" | "paused" | "idle";
12
+ export type MutationStatus = "idle" | "pending" | "success" | "error";
13
+ export type RetryValue = boolean | number | ((failureCount: number, error: any) => boolean);
14
+ export type RetryDelayValue = number | ((attemptIndex: number, error: any) => number);
15
+ export interface QueryFilters {
16
+ queryKey?: QueryKey;
17
+ exact?: boolean;
18
+ type?: "all" | "active" | "inactive";
19
+ stale?: boolean;
20
+ fetchStatus?: FetchStatus;
21
+ predicate?: (query: any) => boolean;
22
+ }
23
+ export interface QueryState<TData = unknown, TError = any> {
24
+ data: TData | undefined;
25
+ error: TError | null;
26
+ status: QueryStatus;
27
+ fetchStatus: FetchStatus;
28
+ dataUpdatedAt: number;
29
+ errorUpdatedAt: number;
30
+ failureCount: number;
31
+ isInvalidated: boolean;
32
+ }
33
+ export interface QueryOptions<TData = unknown, _TError = any, TQueryKey extends QueryKey = QueryKey> {
34
+ queryKey: TQueryKey;
35
+ queryFn?: QueryFunction<TData, TQueryKey>;
36
+ enabled?: boolean | (() => boolean);
37
+ staleTime?: number;
38
+ gcTime?: number;
39
+ retry?: RetryValue;
40
+ retryDelay?: RetryDelayValue;
41
+ refetchInterval?: number | false | (() => number | false);
42
+ refetchIntervalInBackground?: boolean;
43
+ refetchOnWindowFocus?: boolean | "always";
44
+ refetchOnReconnect?: boolean | "always";
45
+ initialData?: TData | (() => TData);
46
+ initialDataUpdatedAt?: number | (() => number);
47
+ placeholderData?: TData | ((previousData: TData | undefined) => TData);
48
+ meta?: Record<string, unknown>;
49
+ }
50
+ export interface CreateQueryOptions<TData = unknown, TError = any, TSelected = TData, TQueryKey extends QueryKey = QueryKey> extends QueryOptions<TData, TError, TQueryKey> {
51
+ select?: (data: TData) => TSelected;
52
+ suspense?: boolean;
53
+ }
54
+ export interface RefetchOptions {
55
+ throwOnError?: boolean;
56
+ cancelRefetch?: boolean;
57
+ }
58
+ export interface QueryResult<TData = unknown, TError = any> {
59
+ data: ReadonlySignal<TData | undefined>;
60
+ error: ReadonlySignal<TError | null>;
61
+ status: ReadonlySignal<QueryStatus>;
62
+ fetchStatus: ReadonlySignal<FetchStatus>;
63
+ isLoading: ReadonlySignal<boolean>;
64
+ isFetching: ReadonlySignal<boolean>;
65
+ isSuccess: ReadonlySignal<boolean>;
66
+ isError: ReadonlySignal<boolean>;
67
+ isStale: ReadonlySignal<boolean>;
68
+ dataUpdatedAt: ReadonlySignal<number>;
69
+ errorUpdatedAt: ReadonlySignal<number>;
70
+ refetch: (options?: RefetchOptions) => Promise<TData | undefined>;
71
+ (): TData | undefined;
72
+ }
73
+ export type MutationFunction<TData = unknown, TVariables = void> = (variables: TVariables) => Promise<TData>;
74
+ export interface MutationOptions<TData = unknown, TError = any, TVariables = void, TContext = unknown> {
75
+ mutationKey?: QueryKey;
76
+ mutationFn: MutationFunction<TData, TVariables>;
77
+ onMutate?: (variables: TVariables) => Promise<TContext | void> | TContext | void;
78
+ onSuccess?: (data: TData, variables: TVariables, context: TContext | undefined) => Promise<void> | void;
79
+ onError?: (error: TError, variables: TVariables, context: TContext | undefined) => Promise<void> | void;
80
+ onSettled?: (data: TData | undefined, error: TError | null, variables: TVariables, context: TContext | undefined) => Promise<void> | void;
81
+ retry?: RetryValue;
82
+ retryDelay?: RetryDelayValue;
83
+ meta?: Record<string, unknown>;
84
+ }
85
+ export interface MutateOptions<TData = unknown, TError = any, TVariables = void, TContext = unknown> {
86
+ onSuccess?: (data: TData, variables: TVariables, context: TContext | undefined) => void;
87
+ onError?: (error: TError, variables: TVariables, context: TContext | undefined) => void;
88
+ onSettled?: (data: TData | undefined, error: TError | null, variables: TVariables, context: TContext | undefined) => void;
89
+ }
90
+ export interface MutationResult<TData = unknown, TError = any, TVariables = void, TContext = unknown> {
91
+ mutate: (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => void;
92
+ mutateAsync: (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => Promise<TData>;
93
+ data: ReadonlySignal<TData | undefined>;
94
+ error: ReadonlySignal<TError | null>;
95
+ status: ReadonlySignal<MutationStatus>;
96
+ isIdle: ReadonlySignal<boolean>;
97
+ isPending: ReadonlySignal<boolean>;
98
+ isLoading: ReadonlySignal<boolean>;
99
+ isSuccess: ReadonlySignal<boolean>;
100
+ isError: ReadonlySignal<boolean>;
101
+ reset: () => void;
102
+ variables: ReadonlySignal<TVariables | undefined>;
103
+ submittedAt: ReadonlySignal<number>;
104
+ (): TData | undefined;
105
+ }
106
+ export interface InfiniteData<TData = unknown, TPageParam = unknown> {
107
+ pages: TData[];
108
+ pageParams: TPageParam[];
109
+ }
110
+ export interface InfiniteQueryOptions<TData = unknown, TError = any, TPageParam = unknown, TSelected = InfiniteData<TData, TPageParam>, TQueryKey extends QueryKey = QueryKey> extends Omit<QueryOptions<InfiniteData<TData, TPageParam>, TError, TQueryKey>, "queryFn"> {
111
+ queryFn?: (context: QueryFunctionContext<TQueryKey, TPageParam>) => Promise<TData> | TData;
112
+ initialPageParam: TPageParam;
113
+ getNextPageParam: (lastPage: TData, allPages: TData[], lastPageParam: TPageParam, allPageParams: TPageParam[]) => TPageParam | undefined | null;
114
+ getPreviousPageParam?: (firstPage: TData, allPages: TData[], firstPageParam: TPageParam, allPageParams: TPageParam[]) => TPageParam | undefined | null;
115
+ maxPages?: number;
116
+ select?: (data: InfiniteData<TData, TPageParam>) => TSelected;
117
+ suspense?: boolean;
118
+ }
119
+ export interface InfiniteQueryResult<TData = unknown, TError = any, TPageParam = unknown> extends Omit<QueryResult<InfiniteData<TData, TPageParam>, TError>, "refetch"> {
120
+ fetchNextPage: () => Promise<InfiniteData<TData, TPageParam> | undefined>;
121
+ fetchPreviousPage: () => Promise<InfiniteData<TData, TPageParam> | undefined>;
122
+ hasNextPage: ReadonlySignal<boolean>;
123
+ hasPreviousPage: ReadonlySignal<boolean>;
124
+ isFetchingNextPage: ReadonlySignal<boolean>;
125
+ isFetchingPreviousPage: ReadonlySignal<boolean>;
126
+ refetch: (options?: RefetchOptions) => Promise<InfiniteData<TData, TPageParam> | undefined>;
127
+ }
128
+ export interface DefaultOptions {
129
+ queries?: Partial<QueryOptions<any, any, any>>;
130
+ mutations?: Partial<MutationOptions<any, any, any, any>>;
131
+ }
@@ -0,0 +1,16 @@
1
+ import type { QueryFilters } from "./types";
2
+ export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
3
+ /**
4
+ * Deterministic JSON stringifier for consistent query key hashing
5
+ */
6
+ export declare function hashKey(queryKey: unknown): string;
7
+ /**
8
+ * Deep equality check for primitives, arrays, and objects
9
+ */
10
+ export declare function deepEqual(a: unknown, b: unknown): boolean;
11
+ /**
12
+ * Partial matching check: matches if `a` is a subset or partial structure of `b`
13
+ */
14
+ export declare function partialDeepEqual(a: unknown, b: unknown): boolean;
15
+ export declare function matchQuery(filters: QueryFilters | undefined, query: any): boolean;
16
+ export declare function sleep(ms: number): Promise<void>;
@@ -0,0 +1 @@
1
+ export { Link, type LinkProps, type LocationState, lazy, type MatchedRoute, Route, type RouteDefinition, type RouteProps, Router, type RouterContextValue, type RouterProps, Routes, type RoutesProps, useLocation, useNavigate, useParams, useSearchParams } from "./router";
@@ -848,10 +848,12 @@ class Signal {
848
848
  _value;
849
849
  _subscribers = new Set;
850
850
  _equals;
851
+ _onSet;
851
852
  version = 0;
852
- constructor(initialValue, equals) {
853
+ constructor(initialValue, equals, onSet) {
853
854
  this._value = initialValue;
854
855
  this._equals = equals ?? Object.is;
856
+ this._onSet = onSet;
855
857
  }
856
858
  get() {
857
859
  if (currentSubscriber !== null && currentSubscriber.state !== 3 /* DISPOSED */) {
@@ -876,6 +878,9 @@ class Signal {
876
878
  }
877
879
  this._value = newValue;
878
880
  this.version++;
881
+ if (this._onSet) {
882
+ this._onSet(newValue);
883
+ }
879
884
  batch(() => {
880
885
  this.notify();
881
886
  });
@@ -901,11 +906,91 @@ class Signal {
901
906
  }
902
907
  }
903
908
  }
909
+ function resolveStorage(storageOption) {
910
+ if (storageOption && typeof storageOption === "object") {
911
+ return storageOption;
912
+ }
913
+ if (storageOption === "session") {
914
+ try {
915
+ if (typeof sessionStorage !== "undefined")
916
+ return sessionStorage;
917
+ } catch {}
918
+ try {
919
+ if (typeof window !== "undefined" && window.sessionStorage) {
920
+ return window.sessionStorage;
921
+ }
922
+ } catch {}
923
+ try {
924
+ if (typeof globalThis !== "undefined" && globalThis.sessionStorage) {
925
+ return globalThis.sessionStorage;
926
+ }
927
+ } catch {}
928
+ return null;
929
+ }
930
+ try {
931
+ if (typeof localStorage !== "undefined")
932
+ return localStorage;
933
+ } catch {}
934
+ try {
935
+ if (typeof window !== "undefined" && window.localStorage) {
936
+ return window.localStorage;
937
+ }
938
+ } catch {}
939
+ try {
940
+ if (typeof globalThis !== "undefined" && globalThis.localStorage) {
941
+ return globalThis.localStorage;
942
+ }
943
+ } catch {}
944
+ return null;
945
+ }
904
946
  function signal(initialValue, optionsOrEquals) {
905
947
  const equals = typeof optionsOrEquals === "function" ? optionsOrEquals : optionsOrEquals?.equals;
906
948
  const isInternal = typeof optionsOrEquals === "object" ? optionsOrEquals?.internal : false;
907
949
  const customName = typeof optionsOrEquals === "object" ? optionsOrEquals?.name : undefined;
908
- const s = new Signal(initialValue, equals);
950
+ const persistOption = typeof optionsOrEquals === "object" ? optionsOrEquals?.persist : undefined;
951
+ const persistConfig = persistOption ? typeof persistOption === "string" ? { key: persistOption } : persistOption : undefined;
952
+ let effectiveInitial = initialValue;
953
+ const storage = persistConfig ? resolveStorage(persistConfig.storage) : null;
954
+ const serialize = persistConfig?.serialize ?? JSON.stringify;
955
+ const deserialize = persistConfig?.deserialize ?? JSON.parse;
956
+ if (persistConfig && storage) {
957
+ try {
958
+ const stored = storage.getItem(persistConfig.key);
959
+ if (stored !== null) {
960
+ effectiveInitial = deserialize(stored);
961
+ }
962
+ } catch {}
963
+ }
964
+ let isSyncing = false;
965
+ const onSet = persistConfig && storage ? (val) => {
966
+ if (isSyncing)
967
+ return;
968
+ try {
969
+ storage.setItem(persistConfig.key, serialize(val));
970
+ } catch {}
971
+ } : undefined;
972
+ const s = new Signal(effectiveInitial, equals, onSet);
973
+ if (persistConfig && storage && (persistConfig.syncTabs ?? true) && typeof window !== "undefined" && typeof window.addEventListener === "function") {
974
+ const onStorage = (e) => {
975
+ if (e.key === persistConfig.key) {
976
+ try {
977
+ const nextVal = e.newValue !== null ? deserialize(e.newValue) : initialValue;
978
+ isSyncing = true;
979
+ try {
980
+ s.set(nextVal);
981
+ } finally {
982
+ isSyncing = false;
983
+ }
984
+ } catch {}
985
+ }
986
+ };
987
+ window.addEventListener("storage", onStorage);
988
+ if (currentScope) {
989
+ currentScope.addCleanup(() => {
990
+ window.removeEventListener("storage", onStorage);
991
+ });
992
+ }
993
+ }
909
994
  const accessor = (...args) => {
910
995
  if (args.length === 0) {
911
996
  return s.get();
@@ -0,0 +1,91 @@
1
+ import { type Child } from "../dom";
2
+ import { type ReadonlySignal } from "../signals";
3
+ export interface LocationState {
4
+ pathname: ReadonlySignal<string>;
5
+ search: ReadonlySignal<string>;
6
+ hash: ReadonlySignal<string>;
7
+ }
8
+ export interface RouterContextValue {
9
+ location: LocationState;
10
+ navigate: (to: string, options?: {
11
+ replace?: boolean;
12
+ }) => void;
13
+ params: ReadonlySignal<Record<string, string>>;
14
+ base: string;
15
+ matchedRoute: ReadonlySignal<MatchedRoute | null>;
16
+ routes: RouteDefinition[];
17
+ registerRoute: (route: RouteDefinition) => void;
18
+ }
19
+ export interface MatchedRoute {
20
+ path: string;
21
+ params: Record<string, string>;
22
+ component?: (props?: any) => Child;
23
+ children?: Child;
24
+ }
25
+ export interface RouteDefinition {
26
+ path: string;
27
+ component?: (props?: any) => Child;
28
+ children?: Child;
29
+ matcher: RegExp;
30
+ paramNames: string[];
31
+ }
32
+ export interface RouterProps {
33
+ base?: string;
34
+ mode?: "history" | "hash";
35
+ children: Child;
36
+ }
37
+ /**
38
+ * Root Router provider managing browser location state and URL synchronization
39
+ */
40
+ export declare function Router(props: RouterProps): Child;
41
+ export interface RouteProps {
42
+ path: string;
43
+ component?: (props: any) => Child;
44
+ children?: Child;
45
+ }
46
+ /**
47
+ * Route declaration registering URL path pattern and view component
48
+ */
49
+ export declare function Route(props: RouteProps): Child;
50
+ export interface RoutesProps {
51
+ children: Child;
52
+ fallback?: Child;
53
+ }
54
+ /**
55
+ * Routes outlet matching the current URL to registered Route definitions
56
+ */
57
+ export declare function Routes(props: RoutesProps): Child;
58
+ export interface LinkProps {
59
+ href: string;
60
+ class?: string | (() => string);
61
+ activeClass?: string;
62
+ replace?: boolean;
63
+ children: Child;
64
+ [key: string]: any;
65
+ }
66
+ /**
67
+ * Accessible client-side navigation Link with active state highlighting
68
+ */
69
+ export declare function Link(props: LinkProps): Child;
70
+ /**
71
+ * Access the active router location state signals
72
+ */
73
+ export declare function useLocation(): LocationState;
74
+ /**
75
+ * Access the imperative navigate function
76
+ */
77
+ export declare function useNavigate(): (to: string, options?: {
78
+ replace?: boolean;
79
+ }) => void;
80
+ /**
81
+ * Access reactive URL parameter signals
82
+ */
83
+ export declare function useParams<T extends Record<string, string> = Record<string, string>>(): () => T;
84
+ /**
85
+ * Access and manipulate URL query search parameters reactively
86
+ */
87
+ export declare function useSearchParams(): [
88
+ () => URLSearchParams,
89
+ (params: Record<string, string> | URLSearchParams) => void
90
+ ];
91
+ export { lazy } from "../dom";
@@ -0,0 +1,2 @@
1
+ import type { ClientOptions, ClientRouter, Router } from "./types";
2
+ export declare function createClient<TRouter extends Router<any, any>>(options: ClientOptions): ClientRouter<TRouter>;
@@ -0,0 +1,16 @@
1
+ import type { ValidationIssue } from "../form/schema";
2
+ import type { RPCErrorCode } from "./types";
3
+ export declare const ERROR_CODE_TO_STATUS: Record<RPCErrorCode, number>;
4
+ export declare const STATUS_TO_ERROR_CODE: Record<number, RPCErrorCode>;
5
+ export declare class RPCError extends Error {
6
+ readonly code: RPCErrorCode;
7
+ readonly status: number;
8
+ readonly issues?: ValidationIssue[];
9
+ constructor(codeOrStatusOrOptions: RPCErrorCode | number | {
10
+ code: RPCErrorCode;
11
+ message?: string;
12
+ issues?: ValidationIssue[];
13
+ cause?: unknown;
14
+ }, message?: string);
15
+ get statusCode(): number;
16
+ }
@@ -0,0 +1,7 @@
1
+ export { Schema, type SchemaLike, type StandardSchemaV1, type ValidationIssue, type ValidationResult, v, validateWithSchema } from "../form/schema";
2
+ export { createClient } from "./client";
3
+ export { ERROR_CODE_TO_STATUS, RPCError, STATUS_TO_ERROR_CODE } from "./error";
4
+ export { createProcedure, executeProcedure } from "./procedure";
5
+ export { createRouter, mutation, query, RouterImpl, subscription } from "./router";
6
+ export { createFetchHandler } from "./server";
7
+ export type { ClientMutationMethod, ClientOptions, ClientProcedure, ClientQueryMethod, ClientRouter, ClientSubscriptionMethod, CORSOptions, FetchHandlerOptions, InferProcedureInput, InferProcedureOutput, MiddlewareFn, Procedure, ProcedureOptions, ProcedureRecord, ProcedureType, Router, Router as RPCRouter, RPCErrorCode, RPCResponse, RPCResponseError, RPCResponseSuccess, SubscriptionCallbacks, SubscriptionHandle } from "./types";
@@ -1058,10 +1058,12 @@ class Signal {
1058
1058
  _value;
1059
1059
  _subscribers = new Set;
1060
1060
  _equals;
1061
+ _onSet;
1061
1062
  version = 0;
1062
- constructor(initialValue, equals) {
1063
+ constructor(initialValue, equals, onSet) {
1063
1064
  this._value = initialValue;
1064
1065
  this._equals = equals ?? Object.is;
1066
+ this._onSet = onSet;
1065
1067
  }
1066
1068
  get() {
1067
1069
  if (currentSubscriber !== null && currentSubscriber.state !== 3 /* DISPOSED */) {
@@ -1086,6 +1088,9 @@ class Signal {
1086
1088
  }
1087
1089
  this._value = newValue;
1088
1090
  this.version++;
1091
+ if (this._onSet) {
1092
+ this._onSet(newValue);
1093
+ }
1089
1094
  batch(() => {
1090
1095
  this.notify();
1091
1096
  });
@@ -1111,11 +1116,91 @@ class Signal {
1111
1116
  }
1112
1117
  }
1113
1118
  }
1119
+ function resolveStorage(storageOption) {
1120
+ if (storageOption && typeof storageOption === "object") {
1121
+ return storageOption;
1122
+ }
1123
+ if (storageOption === "session") {
1124
+ try {
1125
+ if (typeof sessionStorage !== "undefined")
1126
+ return sessionStorage;
1127
+ } catch {}
1128
+ try {
1129
+ if (typeof window !== "undefined" && window.sessionStorage) {
1130
+ return window.sessionStorage;
1131
+ }
1132
+ } catch {}
1133
+ try {
1134
+ if (typeof globalThis !== "undefined" && globalThis.sessionStorage) {
1135
+ return globalThis.sessionStorage;
1136
+ }
1137
+ } catch {}
1138
+ return null;
1139
+ }
1140
+ try {
1141
+ if (typeof localStorage !== "undefined")
1142
+ return localStorage;
1143
+ } catch {}
1144
+ try {
1145
+ if (typeof window !== "undefined" && window.localStorage) {
1146
+ return window.localStorage;
1147
+ }
1148
+ } catch {}
1149
+ try {
1150
+ if (typeof globalThis !== "undefined" && globalThis.localStorage) {
1151
+ return globalThis.localStorage;
1152
+ }
1153
+ } catch {}
1154
+ return null;
1155
+ }
1114
1156
  function signal(initialValue, optionsOrEquals) {
1115
1157
  const equals = typeof optionsOrEquals === "function" ? optionsOrEquals : optionsOrEquals?.equals;
1116
1158
  const isInternal = typeof optionsOrEquals === "object" ? optionsOrEquals?.internal : false;
1117
1159
  const customName = typeof optionsOrEquals === "object" ? optionsOrEquals?.name : undefined;
1118
- const s = new Signal(initialValue, equals);
1160
+ const persistOption = typeof optionsOrEquals === "object" ? optionsOrEquals?.persist : undefined;
1161
+ const persistConfig = persistOption ? typeof persistOption === "string" ? { key: persistOption } : persistOption : undefined;
1162
+ let effectiveInitial = initialValue;
1163
+ const storage = persistConfig ? resolveStorage(persistConfig.storage) : null;
1164
+ const serialize = persistConfig?.serialize ?? JSON.stringify;
1165
+ const deserialize = persistConfig?.deserialize ?? JSON.parse;
1166
+ if (persistConfig && storage) {
1167
+ try {
1168
+ const stored = storage.getItem(persistConfig.key);
1169
+ if (stored !== null) {
1170
+ effectiveInitial = deserialize(stored);
1171
+ }
1172
+ } catch {}
1173
+ }
1174
+ let isSyncing = false;
1175
+ const onSet = persistConfig && storage ? (val) => {
1176
+ if (isSyncing)
1177
+ return;
1178
+ try {
1179
+ storage.setItem(persistConfig.key, serialize(val));
1180
+ } catch {}
1181
+ } : undefined;
1182
+ const s = new Signal(effectiveInitial, equals, onSet);
1183
+ if (persistConfig && storage && (persistConfig.syncTabs ?? true) && typeof window !== "undefined" && typeof window.addEventListener === "function") {
1184
+ const onStorage = (e) => {
1185
+ if (e.key === persistConfig.key) {
1186
+ try {
1187
+ const nextVal = e.newValue !== null ? deserialize(e.newValue) : initialValue;
1188
+ isSyncing = true;
1189
+ try {
1190
+ s.set(nextVal);
1191
+ } finally {
1192
+ isSyncing = false;
1193
+ }
1194
+ } catch {}
1195
+ }
1196
+ };
1197
+ window.addEventListener("storage", onStorage);
1198
+ if (currentScope) {
1199
+ currentScope.addCleanup(() => {
1200
+ window.removeEventListener("storage", onStorage);
1201
+ });
1202
+ }
1203
+ }
1119
1204
  const accessor = (...args) => {
1120
1205
  if (args.length === 0) {
1121
1206
  return s.get();
@@ -0,0 +1,8 @@
1
+ import type { MiddlewareFn, Procedure, ProcedureOptions, ProcedureType } from "./types";
2
+ export declare function createProcedure<TType extends ProcedureType, TInput = any, TOutput = any, TContext = any>(type: TType, options: ProcedureOptions<TInput, TOutput, TContext>, middlewares?: MiddlewareFn<any, any>[]): Procedure<TType, TInput, TOutput, TContext>;
3
+ export declare function executeProcedure(procedure: Procedure<any, any, any, any>, opts: {
4
+ rawInput: unknown;
5
+ ctx: any;
6
+ req: Request;
7
+ signal: AbortSignal;
8
+ }): Promise<any>;
@@ -0,0 +1,19 @@
1
+ import type { MiddlewareFn, Procedure, ProcedureOptions, ProcedureRecord, Router } from "./types";
2
+ export declare class RouterImpl<TRecord extends ProcedureRecord = ProcedureRecord, TContext = any> implements Router<TRecord, TContext> {
3
+ _def: {
4
+ record: TRecord;
5
+ middlewares: MiddlewareFn<any, any>[];
6
+ };
7
+ constructor(record?: TRecord, middlewares?: MiddlewareFn<any, any>[]);
8
+ query(name: string, options: any): any;
9
+ mutation(name: string, options: any): any;
10
+ subscription(name: string, options: any): any;
11
+ use<TNewContext = TContext>(middleware: MiddlewareFn<TContext, TNewContext>): Router<TRecord, TNewContext>;
12
+ merge<TPrefix extends string, TSubRecord extends ProcedureRecord>(prefix: TPrefix, router: Router<TSubRecord, TContext>): Router<TRecord & {
13
+ [K in TPrefix]: Router<TSubRecord, TContext>;
14
+ }, TContext>;
15
+ }
16
+ export declare function createRouter<TRecord extends ProcedureRecord = Record<string, never>, TContext = any>(record?: TRecord): Router<TRecord, TContext>;
17
+ export declare function query<TInput = any, TOutput = any, TContext = any>(options: ProcedureOptions<TInput, TOutput, TContext>): Procedure<"query", TInput, TOutput, TContext>;
18
+ export declare function mutation<TInput = any, TOutput = any, TContext = any>(options: ProcedureOptions<TInput, TOutput, TContext>): Procedure<"mutation", TInput, TOutput, TContext>;
19
+ export declare function subscription<TInput = any, TOutput = any, TContext = any>(options: ProcedureOptions<TInput, TOutput, TContext>): Procedure<"subscription", TInput, TOutput, TContext>;
@@ -0,0 +1,3 @@
1
+ import type { FetchHandlerOptions, Router } from "./types";
2
+ export declare function matchesRulePattern(pattern: string, urlPath: string, procedurePath: string): boolean;
3
+ export declare function createFetchHandler<TRouter extends Router<any, any>, TContext = any>(options: FetchHandlerOptions<TRouter, TContext>): (request: Request, ...extra: any[]) => Promise<Response>;