akanjs 3.0.0-beta.16 → 3.0.0-beta.18

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 (95) hide show
  1. package/base/base.ts +1 -1
  2. package/client/csrTypes.ts +1 -31
  3. package/client/frameConfig.ts +2 -2
  4. package/client/route/RootLayoutDefinition.ts +0 -6
  5. package/client/route/RouteDefinition.ts +1 -13
  6. package/common/CodeTranscript.ts +12 -0
  7. package/common/codeAgentProfile.ts +54 -0
  8. package/common/codeAgentWire.ts +31 -0
  9. package/common/index.ts +5 -0
  10. package/common/routeConvention.ts +0 -3
  11. package/constant/constantRegistry.ts +8 -11
  12. package/document/dataLoader.ts +48 -15
  13. package/document/loaderInfo.ts +28 -7
  14. package/fetch/client/fetchClient.ts +14 -12
  15. package/fetch/client/httpClient.ts +1 -1
  16. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  17. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  18. package/package.json +1 -1
  19. package/server/akanServer.ts +3 -1
  20. package/server/console.ts +9 -9
  21. package/server/decorators.ts +3 -64
  22. package/server/devtools/depsSerializer.ts +1 -4
  23. package/server/di/diLifecycle.ts +1 -3
  24. package/server/head.tsx +60 -0
  25. package/server/imageOptimizer.ts +3 -1
  26. package/server/resolver/database.resolver.ts +29 -26
  27. package/server/routeElementComposer.tsx +3 -3
  28. package/server/routeTreeBuilder.ts +1 -24
  29. package/server/rscWorker.tsx +10 -21
  30. package/server/webRouter.ts +12 -8
  31. package/service/injectInfo.ts +86 -72
  32. package/service/predefinedAdaptor/cache.adaptor.ts +42 -8
  33. package/service/predefinedAdaptor/storage.adaptor.ts +6 -6
  34. package/signal/endpointCache.ts +75 -0
  35. package/signal/guard.ts +4 -3
  36. package/signal/middleware.ts +0 -77
  37. package/signal/signalContext.ts +4 -14
  38. package/signal/types.ts +4 -5
  39. package/types/client/csrTypes.d.ts +1 -31
  40. package/types/client/route/RootLayoutDefinition.d.ts +0 -1
  41. package/types/client/route/RouteDefinition.d.ts +1 -3
  42. package/types/common/CodeTranscript.d.ts +3 -1
  43. package/types/common/codeAgentProfile.d.ts +54 -0
  44. package/types/common/codeAgentWire.d.ts +28 -0
  45. package/types/common/index.d.ts +2 -2
  46. package/types/constant/constantRegistry.d.ts +2 -2
  47. package/types/document/dataLoader.d.ts +6 -1
  48. package/types/document/loaderInfo.d.ts +9 -4
  49. package/types/server/console.d.ts +1 -1
  50. package/types/server/decorators.d.ts +1 -8
  51. package/types/server/head.d.ts +10 -0
  52. package/types/server/routeElementComposer.d.ts +1 -1
  53. package/types/service/injectInfo.d.ts +17 -14
  54. package/types/service/predefinedAdaptor/cache.adaptor.d.ts +1 -0
  55. package/types/service/predefinedAdaptor/storage.adaptor.d.ts +1 -2
  56. package/types/signal/endpointCache.d.ts +19 -0
  57. package/types/signal/guard.d.ts +4 -3
  58. package/types/signal/middleware.d.ts +0 -20
  59. package/types/signal/signalContext.d.ts +1 -6
  60. package/types/signal/types.d.ts +4 -5
  61. package/types/ui/Agent/Menu.d.ts +2 -2
  62. package/types/ui/Button.d.ts +1 -1
  63. package/types/ui/CsrImage.d.ts +2 -1
  64. package/types/ui/Data/Item.d.ts +1 -1
  65. package/types/ui/Link/CsrLink.d.ts +1 -1
  66. package/types/ui/Link/types.d.ts +2 -0
  67. package/types/ui/System/CSR.d.ts +2 -2
  68. package/types/ui/System/Client.d.ts +2 -3
  69. package/types/ui/System/Common.d.ts +0 -2
  70. package/types/ui/System/SSR.d.ts +2 -2
  71. package/types/ui/recipe/inputRecipe.d.ts +1 -1
  72. package/ui/Agent/Menu.tsx +2 -2
  73. package/ui/Button.tsx +1 -1
  74. package/ui/Constant/Doc.tsx +121 -77
  75. package/ui/Constant/Graph.tsx +11 -3
  76. package/ui/CsrImage.tsx +3 -2
  77. package/ui/Data/Item.tsx +1 -1
  78. package/ui/Field/Choice.tsx +1 -1
  79. package/ui/Field/Collection.tsx +4 -3
  80. package/ui/Image.tsx +1 -0
  81. package/ui/Link/CsrLink.tsx +5 -1
  82. package/ui/Link/types.ts +2 -0
  83. package/ui/System/CSR.tsx +1 -9
  84. package/ui/System/Client.tsx +2 -4
  85. package/ui/System/Common.tsx +0 -2
  86. package/ui/System/SSR.tsx +1 -9
  87. package/ui/recipe/inputRecipe.ts +1 -1
  88. package/webkit/bootCsr.tsx +0 -12
  89. package/webkit/useCamera.tsx +4 -3
  90. package/webkit/useCsrValues.ts +3 -3
  91. package/webkit/useFetch.ts +6 -7
  92. package/server/metadata.tsx +0 -198
  93. package/types/server/metadata.d.ts +0 -22
  94. package/types/ui/System/Gtag.d.ts +0 -4
  95. package/ui/System/Gtag.tsx +0 -69
@@ -12,6 +12,5 @@ export declare class RootLayoutDefinition<Args extends RouteArgsShape = Record<n
12
12
  reconnect(on?: boolean): this;
13
13
  wsConnect(on?: boolean): this;
14
14
  layoutStyle(style: "mobile" | "web"): this;
15
- gaTrackingId(id: string): this;
16
15
  protected extendModule(module: PageModule & LayoutModule): PageModule & LayoutModule;
17
16
  }
@@ -1,13 +1,12 @@
1
1
  import { type PromiseOrObject } from "akanjs/base";
2
2
  import type { ReactNode } from "react";
3
- import type { AkanMetadata, Head, LayoutModule, PageConfig, PageModule } from "../csrTypes.d.ts";
3
+ import type { Head, LayoutModule, PageConfig, PageModule } from "../csrTypes.d.ts";
4
4
  import { type RouteArgInfo, type RouteArgInput, type RouteBaseArgs } from "./routeArgs.d.ts";
5
5
  export type RouteArgsShape = Record<string, unknown>;
6
6
  export type RouteKind = "page" | "layout" | "rootLayout";
7
7
  /** Interned: a definition built inside the pages bundle must be recognised by a loader bundled apart from it. */
8
8
  export declare const routeDefinitionMarker: unique symbol;
9
9
  type HeadStage<Args> = Head | ((args: Args) => PromiseOrObject<Head | null | undefined>);
10
- type MetadataStage<Args> = AkanMetadata | ((args: Args) => PromiseOrObject<AkanMetadata | null | undefined>);
11
10
  export interface RouteArgResolveOption {
12
11
  /** A prompt's arguments are strings a person typed: a list is comma-separated and a bad value is refused. */
13
12
  strict?: boolean;
@@ -23,7 +22,6 @@ export declare abstract class RouteDefinition<Args extends RouteArgsShape = Reco
23
22
  readonly args: RouteArgInfo[];
24
23
  config(config: PageConfig): this;
25
24
  head(head: HeadStage<RouteBaseArgs & Args>): this;
26
- metadata(metadata: MetadataStage<RouteBaseArgs & Args>): this;
27
25
  loading(render: (args: RouteBaseArgs & Args & Extra) => PromiseOrObject<ReactNode>): this;
28
26
  render(render: (args: RouteBaseArgs & Args & Extra) => PromiseOrObject<ReactNode>): this;
29
27
  get pageConfig(): PageConfig | undefined;
@@ -1,4 +1,4 @@
1
- import type { CodeAgentApprovalRequest, CodeAgentEvent, CodeAgentQuestion, CodeAgentSessionInfo, CodeAgentStopReason, CodeAgentToolOutcome, CodeAgentToolSummary } from "akanjs/common";
1
+ import type { CodeAgentApprovalRequest, CodeAgentEvent, CodeAgentQuestion, CodeAgentSessionInfo, CodeAgentStopReason, CodeAgentSubagent, CodeAgentToolOutcome, CodeAgentToolSummary } from "akanjs/common";
2
2
  export type CodeTranscriptPart = {
3
3
  kind: "user";
4
4
  id: string;
@@ -77,6 +77,8 @@ export declare class CodeTranscript {
77
77
  steering: number;
78
78
  followUp: number;
79
79
  };
80
+ /** The sub-agents running right now. Not a transcript row: they are a state, and the state is the list. */
81
+ get subagents(): CodeAgentSubagent[];
80
82
  /** Bumped on every applied event, so a view can tell "changed" from "same" without comparing arrays. */
81
83
  get revision(): number;
82
84
  /**
@@ -17,6 +17,20 @@ export type CodeAgentApprovalPolicy = "never" | "writes" | "commands" | "all";
17
17
  * restart and does not hold a shared workspace for the minutes or days a person may take to answer.
18
18
  */
19
19
  export type CodeAgentInteractionMode = "await" | "suspend";
20
+ export interface CodeAgentModelInfo {
21
+ id: string;
22
+ name: string;
23
+ contextWindow?: number;
24
+ /** Whether this is the one the session is running on, which a listing has to mark rather than repeat. */
25
+ current: boolean;
26
+ }
27
+ /** One provider of the model catalogue, and whether a credential for it has been configured. */
28
+ export interface CodeAgentProviderInfo {
29
+ id: string;
30
+ name: string;
31
+ authorized: boolean;
32
+ models: CodeAgentModelInfo[];
33
+ }
20
34
  export interface CodeAgentMcpServerRef {
21
35
  name: string;
22
36
  transport: "stdio" | "http";
@@ -25,6 +39,46 @@ export interface CodeAgentMcpServerRef {
25
39
  args?: string[];
26
40
  url?: string;
27
41
  env?: Record<string, string>;
42
+ /** Sent on every http request. A server behind a static token needs nothing else. */
43
+ headers?: Record<string, string>;
44
+ /**
45
+ * What to use when the server answers `401` and asks for OAuth.
46
+ *
47
+ * Everything here is optional because the spec is discoverable: the challenge names the resource metadata,
48
+ * that names the authorization server, and most hosted servers register a client on demand. It is for the
49
+ * ones that do not — a provider issuing client ids by hand, or one whose scopes cannot be guessed.
50
+ */
51
+ oauth?: {
52
+ clientId?: string;
53
+ clientSecret?: string;
54
+ scope?: string;
55
+ };
56
+ }
57
+ /**
58
+ * Where a server stands with its credential.
59
+ *
60
+ * `required` is not a failure: it is a server that answered correctly and said who may talk to it. Reporting
61
+ * it as unreachable would send someone to debug a server that is working exactly as designed.
62
+ */
63
+ export type CodeAgentMcpAuthState = "none" | "authorized" | "required";
64
+ /**
65
+ * One declared MCP server, as the session found it.
66
+ *
67
+ * A server that answered and one that was never reachable are both here: an integration that is silently
68
+ * absent is indistinguishable from one the model simply chose not to use, and the tool names are the only
69
+ * evidence of which of the two happened.
70
+ */
71
+ export interface CodeAgentMcpStatus {
72
+ name: string;
73
+ transport: "stdio" | "http";
74
+ /** The command line or the url — what tells two entries of the same shape apart without opening the file. */
75
+ target: string;
76
+ /** Published tool names, already prefixed with the server the way the model sees them. */
77
+ tools: string[];
78
+ /** Why it published none, when it published none. */
79
+ error?: string;
80
+ /** Whether a credential was needed, and whether one was held. */
81
+ auth?: CodeAgentMcpAuthState;
28
82
  }
29
83
  export interface CodeAgentSubagentBudget {
30
84
  maxDepth: number;
@@ -147,6 +147,22 @@ export interface CodeAgentApprovalRequest {
147
147
  summary: string;
148
148
  policy: CodeAgentApprovalPolicy;
149
149
  }
150
+ /**
151
+ * One sub-agent the `task` tool is currently running.
152
+ *
153
+ * `tokens` is read at the moment the frame is made, so a host that draws this rail sees the child's spend
154
+ * climb rather than learning it only once the child is gone — which is the number that decides whether to
155
+ * let it keep going. A finished sub-agent leaves the list: what it did is already in the tool row it closed.
156
+ */
157
+ export interface CodeAgentSubagent {
158
+ /** The `task` call that opened it, so a host can line the row up with the tool row above. */
159
+ id: string;
160
+ kind: string;
161
+ /** The three-to-five words the model named the task with. */
162
+ description: string;
163
+ startedAt: number;
164
+ tokens: number;
165
+ }
150
166
  export type CodeAgentEventBody = {
151
167
  type: "session";
152
168
  info: CodeAgentSessionInfo;
@@ -223,6 +239,18 @@ export type CodeAgentEventBody = {
223
239
  type: "notice";
224
240
  level: "info" | "warning" | "error";
225
241
  message: string;
242
+ }
243
+ /**
244
+ * Every sub-agent running right now, whole rather than as a delta.
245
+ *
246
+ * A list is re-sent on every change and on a slow tick while any child runs, so a host that missed a frame
247
+ * converges on the next one instead of holding a row for a child that finished. It is the one thing a turn
248
+ * does that the transcript cannot show: a `task` call is one tool row that stays open for minutes while its
249
+ * child spends tokens nobody watching sees spent.
250
+ */
251
+ | {
252
+ type: "subagent";
253
+ agents: CodeAgentSubagent[];
226
254
  } | {
227
255
  type: "error";
228
256
  message: string;
@@ -5,8 +5,8 @@ export { CodeTranscript, type CodeTranscriptPart } from "./CodeTranscript.d.ts";
5
5
  export { capitalize } from "./capitalize.d.ts";
6
6
  export { clamp } from "./clamp.d.ts";
7
7
  export { clientAddressFromHeaders, clientPortFromHeaders, forwardedHeaders, normalizeIpAddress, } from "./clientAddress.d.ts";
8
- export { type CodeAgentApprovalPolicy, type CodeAgentBuiltinTool, type CodeAgentInteractionMode, type CodeAgentMcpServerRef, type CodeAgentPresetName, type CodeAgentProfile, type CodeAgentSubagentBudget, codeAgentDeniedPaths, codeAgentPresets, codeAgentReadOnlyBuiltins, isCodeAgentPresetName, } from "./codeAgentProfile.d.ts";
9
- export { type CodeAgentAnswer, type CodeAgentApprovalRequest, type CodeAgentCommand, type CodeAgentCommandType, type CodeAgentEffort, type CodeAgentEvent, type CodeAgentEventBody, type CodeAgentEventType, type CodeAgentFrame, type CodeAgentImage, type CodeAgentQuestion, type CodeAgentQuestionOption, type CodeAgentReply, type CodeAgentRequest, type CodeAgentSessionInfo, type CodeAgentStartOptions, type CodeAgentState, type CodeAgentStopReason, type CodeAgentToolOp, type CodeAgentToolOutcome, type CodeAgentToolSummary, codeAgentClip, codeAgentEventLabel, codeAgentEventPersistence, codeAgentLabelChars, codeAgentOutputChars, codeAgentRenderAnswer, codeAgentSessionName, codeAgentShouldPersist, codeAgentWireVersion, isCodeAgentReply, } from "./codeAgentWire.d.ts";
8
+ export { type CodeAgentApprovalPolicy, type CodeAgentBuiltinTool, type CodeAgentInteractionMode, type CodeAgentMcpAuthState, type CodeAgentMcpServerRef, type CodeAgentMcpStatus, type CodeAgentModelInfo, type CodeAgentPresetName, type CodeAgentProfile, type CodeAgentProviderInfo, type CodeAgentSubagentBudget, codeAgentDeniedPaths, codeAgentPresets, codeAgentReadOnlyBuiltins, isCodeAgentPresetName, } from "./codeAgentProfile.d.ts";
9
+ export { type CodeAgentAnswer, type CodeAgentApprovalRequest, type CodeAgentCommand, type CodeAgentCommandType, type CodeAgentEffort, type CodeAgentEvent, type CodeAgentEventBody, type CodeAgentEventType, type CodeAgentFrame, type CodeAgentImage, type CodeAgentQuestion, type CodeAgentQuestionOption, type CodeAgentReply, type CodeAgentRequest, type CodeAgentSessionInfo, type CodeAgentStartOptions, type CodeAgentState, type CodeAgentStopReason, type CodeAgentSubagent, type CodeAgentToolOp, type CodeAgentToolOutcome, type CodeAgentToolSummary, codeAgentClip, codeAgentEventLabel, codeAgentEventPersistence, codeAgentLabelChars, codeAgentOutputChars, codeAgentRenderAnswer, codeAgentSessionName, codeAgentShouldPersist, codeAgentWireVersion, isCodeAgentReply, } from "./codeAgentWire.d.ts";
10
10
  export { deepObjectify } from "./deepObjectify.d.ts";
11
11
  export type { DynamicRecord } from "./dynamicRecord.d.ts";
12
12
  export { EventStream, type EventStreamOptions } from "./eventStream.d.ts";
@@ -39,8 +39,8 @@ export declare class ConstantRegistry {
39
39
  static getModelRef(refName: string, modelType?: ConstantType): Cls | typeof PrimitiveScalar;
40
40
  static buildModel<T extends string, InputRef extends ConstantModelRef, ObjectRef extends ConstantModelRef, FullFieldObj extends FieldObject, FullRef extends ConstantModelRef<any, FullFieldObj>, LightRef extends ConstantModelRef, InsightRef extends ConstantModelRef, Input = InstanceType<InputRef>, Obj = InstanceType<ObjectRef>, Full = InstanceType<FullRef>, Light = InstanceType<LightRef>, Insight = InstanceType<InsightRef>>(refName: T, inputRef: InputRef, objectRef: ObjectRef, fullRef: FullRef, lightRef: LightRef, insightRef: InsightRef, constExports: Record<string, unknown>): ConstantModel<T, Input, Obj, Full, Light, Insight, FullFieldObj, Capitalize<T>, DefaultOf<Full>, DefaultOf<Input>, GetStateObject<Full>, GetStateObject<Input>, DefaultOf<Insight>, PurifiedModel<Input>, DocumentModel<Full>, DocumentModel<Input>, QueryOf<DocumentModel<Full>>, GetStateObject<Light>, GetStateObject<Insight>>;
41
41
  static buildScalar<T extends string, Model>(refName: T, Model: Cls<Model>, constExports: Record<string, unknown>): ScalarConstantModel<T, Model, DefaultOf<Model>, DocumentModel<Model>, PurifiedModel<Model>>;
42
- static serialize<Value>(modelRef: Cls | Cls[], value: Value, nullable?: boolean): Value;
43
- static deserialize<Value>(modelRef: Cls | Cls[], value: Value, nullable?: boolean): Value;
42
+ static serialize<Value>(modelRef: Cls | Cls[], value: Value, nullable?: boolean, of?: Cls | Cls[]): Value;
43
+ static deserialize<Value>(modelRef: Cls | Cls[], value: Value, nullable?: boolean, of?: Cls | Cls[]): Value;
44
44
  }
45
45
  export interface ConstantModel<T extends string = string, Input = any, Obj = any, Full = any, Light = any, Insight = any, FullFieldObj extends FieldObject = FieldObject, _CapitalizedRefName extends string = Capitalize<T>, _Default = DefaultOf<Full>, _DefaultInput = DefaultOf<Input>, _DefaultState = GetStateObject<Full>, _DefaultStateInput = GetStateObject<Input>, _DefaultInsight = DefaultOf<Insight>, _PurifiedInput = PurifiedModel<Input>, _Doc = DocumentModel<Full>, _DocInput = DocumentModel<Input>, _QueryOfDoc = QueryOf<_Doc>, _StateLight = GetStateObject<Light>, _StateInsight = GetStateObject<Insight>> {
46
46
  refName: T;
@@ -7,7 +7,12 @@ type LoaderModel = {
7
7
  };
8
8
  type BatchLoadFn<Key, Value> = (keys: readonly Key[]) => PromiseLike<ReadonlyArray<Value | Error>> | ReadonlyArray<Value | Error>;
9
9
  interface DataLoaderOptions<Key, CacheKey> {
10
- cache?: boolean;
10
+ /**
11
+ * How long a loaded key is answered from memory: `false` (the default) remembers nothing past its own batch,
12
+ * a number keeps each key for that many milliseconds, and `true` keeps it for the life of the loader. A model's
13
+ * loaders live as long as the process, so anything but `false` serves a stale document after it changes.
14
+ */
15
+ cache?: boolean | number;
11
16
  cacheKeyFn?: (key: Key) => CacheKey;
12
17
  batch?: boolean;
13
18
  batchScheduleFn?: (callback: () => void) => void;
@@ -9,17 +9,22 @@ export type ModelCls<Statics = Record<never, never>, LoaderMap extends {
9
9
  _onSchema: (schema: SchemaOf<any, any>) => void;
10
10
  _libsOnSchema: (schema: SchemaOf<any, any>) => void;
11
11
  }>;
12
+ export interface LoaderOption {
13
+ /** `false` by default; a number of milliseconds, or `true` for as long as the process runs. */
14
+ cache?: boolean | number;
15
+ }
12
16
  export declare class LoaderInfo<Doc = any, Key extends keyof Doc = keyof Doc, QueryArg = Doc[Key]> {
13
17
  type: LoaderType;
14
18
  field: Key | Key[];
15
19
  defaultQuery: QueryOf<unknown>;
20
+ cache: boolean | number;
16
21
  queryArg: QueryArg | undefined;
17
- constructor(type: LoaderType, field: Key | Key[], defaultQuery?: QueryOf<unknown>);
22
+ constructor(type: LoaderType, field: Key | Key[], defaultQuery?: QueryOf<unknown>, { cache }?: LoaderOption);
18
23
  }
19
24
  export declare const makeLoaderBuilder: <Doc>() => {
20
- byField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery?: QueryOf<unknown>) => LoaderInfo<Doc, Key, Doc[Key]>;
21
- byArrayField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery?: QueryOf<unknown>) => LoaderInfo<Doc, Key, Doc[Key]>;
22
- byQuery: <Key extends keyof Doc & string>(queryKeys: readonly Key[], defaultQuery?: QueryOf<unknown>) => LoaderInfo<Doc, Key, Pick<Doc, Key>>;
25
+ byField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery?: QueryOf<unknown>, option?: LoaderOption) => LoaderInfo<Doc, Key, Doc[Key]>;
26
+ byArrayField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery?: QueryOf<unknown>, option?: LoaderOption) => LoaderInfo<Doc, Key, Doc[Key]>;
27
+ byQuery: <Key extends keyof Doc & string>(queryKeys: readonly Key[], defaultQuery?: QueryOf<unknown>, option?: LoaderOption) => LoaderInfo<Doc, Key, Pick<Doc, Key>>;
23
28
  };
24
29
  export type LoaderBuilder<Doc = any> = (builder: ReturnType<typeof makeLoaderBuilder<Doc>>) => {
25
30
  [key: string]: LoaderInfo<Doc, any, any>;
@@ -29,7 +29,7 @@ export interface AkanConsoleContext extends Record<string, unknown> {
29
29
  methods: (value: unknown) => string[];
30
30
  debug: () => ReturnType<AkanServer["inspectConsole"]>;
31
31
  }
32
- export declare const assertAkanConsoleAllowed: (env?: Pick<BaseEnv, "environment" | "operationMode">) => void;
32
+ export declare const assertAkanConsoleAllowed: (env?: Partial<Pick<BaseEnv, "environment" | "operationMode">>) => void;
33
33
  export declare const getAkanConsoleMethods: (value: unknown) => string[];
34
34
  export declare const createAkanConsoleContext: (server: AkanServer, globals?: Record<string, unknown>) => AkanConsoleContext;
35
35
  export declare const startAkanConsole: (server: AkanServer, options?: AkanConsoleOptions) => Promise<void>;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Method decorators for a server class: `@Transaction`, `@Try`, `@CacheMethod`. Kept because `libs/util`'s
2
+ * Method decorators for a server class: `@Transaction`, `@Try`. Kept because `libs/util`'s
3
3
  * storage adaptors use `@Try` on their remote calls; new code follows the adaptor rule instead
4
4
  * (`catch` → `logger.error` → `return null`).
5
5
  */
@@ -7,10 +7,3 @@
7
7
  export declare const Try: () => (_target: unknown, key: string, descriptor: PropertyDescriptor) => void;
8
8
  /** Method decorator that runs the method inside the detected database transaction. */
9
9
  export declare const Transaction: () => MethodDecorator;
10
- /**
11
- * Method decorator that caches method results for the given timeout in milliseconds.
12
- *
13
- * Not `Cache` — `akanjs/signal` exports a `Cache` **middleware class**, and an app importing both barrels got
14
- * one name meaning two things.
15
- */
16
- export declare const CacheMethod: (timeout?: number, getCacheKey?: (...args: unknown[]) => string) => MethodDecorator;
@@ -0,0 +1,10 @@
1
+ import type { Head, ResolvedHead, ResolveHeadResult } from "akanjs/client";
2
+ import { type AkanHeadSnapshotV1 } from "./routeState.d.ts";
3
+ export declare function createAkanLocaleAlternateHeadSnapshot(languages: Record<string, string>): AkanHeadSnapshotV1;
4
+ export declare function mergeAkanHeadSnapshots(...snapshots: Array<AkanHeadSnapshotV1 | null | undefined>): AkanHeadSnapshotV1 | undefined;
5
+ export declare function renderAkanHeadSnapshot(snapshot: AkanHeadSnapshotV1): Head;
6
+ export declare function shouldRenderLocaleAlternates(options: {
7
+ isSpecialRoute?: boolean;
8
+ }): boolean;
9
+ export declare function isResolvedHead(value: unknown): value is ResolvedHead;
10
+ export declare function resolveHeadResult(value: ResolveHeadResult): ResolvedHead;
@@ -30,7 +30,7 @@ export declare class RouteElementComposer {
30
30
  params: Record<string, string>;
31
31
  searchParams: Record<string, string | string[]>;
32
32
  }): Promise<Head | null | undefined>;
33
- static resolveHeadWithMetadata({ pathRoute, params, searchParams, }: {
33
+ static resolveHeadWithSnapshot({ pathRoute, params, searchParams, }: {
34
34
  pathRoute: PathRoute;
35
35
  params: Record<string, string>;
36
36
  searchParams: Record<string, string[] | string>;
@@ -15,7 +15,7 @@ interface InjectBuilderOptions<ReturnType> {
15
15
  local?: boolean;
16
16
  default?: unknown;
17
17
  isMap?: boolean;
18
- cacheOption?: CacheSetOptions;
18
+ ttl?: number;
19
19
  parentRefName: string;
20
20
  }
21
21
  export interface InjectRegistry {
@@ -60,7 +60,8 @@ export declare class InjectInfo<Type extends InjectType = any, ReturnType = any,
60
60
  readonly adaptor?: AdaptorCls;
61
61
  readonly default?: unknown;
62
62
  readonly isMap?: boolean;
63
- readonly cacheOption?: CacheSetOptions;
63
+ /** How long a `memory` value lives by default, in milliseconds — a `set` that names its own `expireAt` wins. */
64
+ readonly ttl?: number;
64
65
  readonly parentRefName: string;
65
66
  constructor(type: Type, options: InjectBuilderOptions<ReturnType>);
66
67
  static resolveInjection(instance: Adaptor | Service, applyCls: AdaptorCls | ServiceCls, registry: InjectRegistry, env: BackendEnv): Promise<void>;
@@ -75,26 +76,28 @@ export declare const injectionBuilder: (parentRefName: string) => {
75
76
  env: <GenFactory extends (arg: never) => unknown>(generateFactory: GenFactory) => InjectInfo<"env", Awaited<ReturnType<GenFactory>>, GenFactory extends (arg: infer Env extends {
76
77
  [key: string]: any;
77
78
  }) => unknown ? Env : never, never>;
78
- memory: <ExplicitType = unknown, ValueRef extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = never, DefaultValue extends GetFieldValue<ValueRef, ExplicitType> = never, GetFn extends (value: GetFieldValue<ValueRef, ExplicitType>) => unknown = never, Local extends boolean = false>(modelRef: ValueRef, opts?: {
79
+ memory: <ExplicitType = unknown, ValueRef extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = never, DefaultValue extends GetFieldValue<ValueRef, ExplicitType> = never, GetFn extends (value: MapConstructor extends ValueRef ? FieldToValue<MapValue> : GetFieldValue<ValueRef, ExplicitType>) => unknown = never, Local extends boolean = false>(modelRef: ValueRef, opts?: {
79
80
  local?: Local;
80
81
  default?: DefaultValue;
81
82
  of?: MapValue;
82
- expireAt?: CacheSetOptions["expireAt"];
83
+ /** Milliseconds each write lives unless the `set` call names its own `expireAt`. */
84
+ ttl?: number;
85
+ /** Turns the stored value — a Map's entry value — into what the code reads; `set` is its inverse. */
83
86
  get?: GetFn;
84
- set?: (value: ReturnType<GetFn>) => GetFieldValue<ValueRef, ExplicitType>;
85
- }) => InjectInfo<"memory", Local extends true ? MapConstructor extends ValueRef ? Map<string, FieldToValue<MapValue>> : (DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn> : MapConstructor extends ValueRef ? {
86
- get: (key: string) => Promise<(never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) | undefined>;
87
- set: (key: string, value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<void>;
87
+ set?: (value: ReturnType<GetFn>) => MapConstructor extends ValueRef ? FieldToValue<MapValue> : GetFieldValue<ValueRef, ExplicitType>;
88
+ }) => InjectInfo<"memory", Local extends true ? MapConstructor extends ValueRef ? Map<string, FieldToValue<MapValue>> : (DefaultValue extends never ? true : false) extends true ? ([GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : [GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn> : MapConstructor extends ValueRef ? {
89
+ get: (key: string) => Promise<([GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>) | undefined>;
90
+ set: (key: string, value: [GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<void>;
88
91
  delete: (key: string) => Promise<void>;
89
- getOrInsert: (key: string, value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>;
90
- getOrInsertComputed: (key: string, compute: (key: string) => (never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) | Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>, option?: CacheSetOptions) => Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>;
92
+ getOrInsert: (key: string, value: [GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<[GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>>;
93
+ getOrInsertComputed: (key: string, compute: (key: string) => ([GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>) | Promise<[GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>>, option?: CacheSetOptions) => Promise<[GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>>;
91
94
  keys: () => Promise<string[]>;
92
- entries: () => Promise<[string, never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>][]>;
93
- forEach: (callback: (value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>, key: string) => void | Promise<void>) => Promise<void>;
95
+ entries: () => Promise<[string, [GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>][]>;
96
+ forEach: (callback: (value: [GetFn] extends [never] ? FieldToValue<MapValue> : ReturnType<GetFn>, key: string) => void | Promise<void>) => Promise<void>;
94
97
  clear: () => Promise<void>;
95
98
  } : {
96
- get: () => Promise<(DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>>;
97
- set: (value: (DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<void>;
99
+ get: () => Promise<(DefaultValue extends never ? true : false) extends true ? ([GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : [GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>>;
100
+ set: (value: (DefaultValue extends never ? true : false) extends true ? ([GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : [GetFn] extends [never] ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>, option?: CacheSetOptions) => Promise<void>;
98
101
  delete: () => Promise<void>;
99
102
  }, never, ValueRef>;
100
103
  };
@@ -26,6 +26,7 @@ declare const RedisCache_base: import("..").AdaptorCls<{}, {
26
26
  redis: import("..").InjectInfo<"env", Redis, RedisEnv, never>;
27
27
  }>;
28
28
  export declare class RedisCache extends RedisCache_base implements CacheAdaptor {
29
+ #private;
29
30
  set(topic: string, key: string, value: string | number | Buffer, option?: CacheSetOptions): Promise<void>;
30
31
  get<T extends string | number | Buffer>(topic: string, key: string): Promise<T | undefined>;
31
32
  delete(topic: string, key: string): Promise<void>;
@@ -1,4 +1,3 @@
1
- import { type BaseEnv } from "akanjs/base";
2
1
  export interface DownloadRequest {
3
2
  path: string;
4
3
  localPath: string;
@@ -53,7 +52,7 @@ export interface StorageAdaptor {
53
52
  deleteData(url: string): Promise<boolean>;
54
53
  deleteDataByPath(path: string): Promise<boolean>;
55
54
  }
56
- export interface BlobStorageOptions extends BaseEnv {
55
+ export interface BlobStorageOptions {
57
56
  blobStorage?: {
58
57
  baseDir?: string;
59
58
  privateBaseDir?: string;
@@ -0,0 +1,19 @@
1
+ import type { SignalContext } from "./signalContext.d.ts";
2
+ /**
3
+ * Serves an endpoint's own answer back for as long as its declared `cache` allows, and stands aside for every
4
+ * endpoint that declared none — every call passes through here, so a TTL of its own would put a stale window on
5
+ * every call in the app.
6
+ *
7
+ * It runs inside the call, after the guards and the internal arguments, never as a middleware: a middleware sits
8
+ * ahead of the ones a lib registers (the account resolution among them), so a hit served there was judged by
9
+ * guards that could not yet see who was asking. Here a hit reaches only a caller the guards already admitted, and
10
+ * it stays inside the `timeout` deadline, so a cache backend that hangs is bounded like the handler it stands in for.
11
+ *
12
+ * A cached answer is **shared**, which is why only a `query` taking no internal argument can carry one: internal
13
+ * arguments are how a call learns who is asking (`.with(Self)`), so an endpoint that has them answers per caller
14
+ * and one entry would be one caller's answer handed to the next.
15
+ */
16
+ export declare class EndpointCache {
17
+ #private;
18
+ static through(context: SignalContext, run: () => Promise<unknown>): Promise<unknown>;
19
+ }
@@ -8,9 +8,10 @@ export interface Guard {
8
8
  * with no arguments — which is what lets a catalogue hide what the caller certainly cannot use. `resource` needs
9
9
  * the call's arguments and fails closed without them, so evaluating one early would erase legitimate entries.
10
10
  *
11
- * Required, with no default. Exposure is decided by a guard rather than by an opt-in, so an unmarked guard would
12
- * silently take the `resource` path and list its endpoint to every caller — the whole guarded surface's names,
13
- * refused only at call time. There is no safe guess here, so the author states it.
11
+ * `GuardCls` requires it on a hand-written guard class. Exposure is decided by a guard rather than by an opt-in, so
12
+ * an unmarked guard would silently take the `resource` path and list its endpoint to every caller — the whole
13
+ * guarded surface's names, refused only at call time. A class built with `guard(name)` starts as `account`, the
14
+ * side that errs hidden: a subclass reading the call's arguments without overriding it drops out of every listing.
14
15
  */
15
16
  export type GuardScope = "account" | "resource";
16
17
  /**
@@ -21,26 +21,6 @@ declare const Logging_base: {
21
21
  export declare class Logging extends Logging_base {
22
22
  use(): Promise<(context: SignalContext, next: () => Promise<unknown>) => Promise<unknown>>;
23
23
  }
24
- declare const Cache_base: {
25
- new (): {
26
- use(env: BackendEnv): Promise<(context: SignalContext, next: () => Promise<unknown>) => Promise<unknown>>;
27
- };
28
- refName: string;
29
- };
30
- /**
31
- * Serves an endpoint's own answer back for as long as its declared `cache` allows, and stands aside for every
32
- * endpoint that declared none — this is registered by default, so a TTL of its own would put a stale window on
33
- * every call in the app.
34
- *
35
- * A cached answer is **shared**, which is why only a `query` taking no internal argument can carry one: internal
36
- * arguments are how a call learns who is asking (`.with(Self)`), so an endpoint that has them answers per caller
37
- * and one entry would be one caller's answer handed to the next. Guards are re-run on every hit regardless —
38
- * shared is not public, and `next()`, which is what runs them, is exactly what a hit skips.
39
- */
40
- export declare class Cache extends Cache_base {
41
- #private;
42
- use(): Promise<(context: SignalContext, next: () => Promise<unknown>) => Promise<unknown>>;
43
- }
44
24
  declare const Timeout_base: {
45
25
  new (): {
46
26
  use(env: BackendEnv): Promise<(context: SignalContext, next: () => Promise<unknown>) => Promise<unknown>>;
@@ -56,15 +56,10 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
56
56
  getAdaptor<T extends Adaptor>(adaptorCls: AdaptorCls<T>): T;
57
57
  getService<T>(refName: string): T;
58
58
  init(): Promise<this>;
59
- /**
60
- * The endpoint's guards, for a middleware that answers a call without executing it — a cache hit skips
61
- * `next()`, and `next()` is what would otherwise run them. Side-effect free, like the guards themselves.
62
- */
63
- checkGuards(): Promise<void>;
64
59
  /**
65
60
  * Re-checks this context's guards outside of a request, for a websocket room that is already
66
61
  * subscribed. Only global middlewares run: they carry the account resolution this depends on,
67
- * while endpoint middlewares (cache/retry) would observe a call that never executes.
62
+ * while endpoint middlewares would observe a call that never executes.
68
63
  */
69
64
  authorize(): Promise<boolean>;
70
65
  /**
@@ -80,14 +80,13 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
80
80
  timeout?: number;
81
81
  partial?: _Key[] | readonly _Key[];
82
82
  /**
83
- * How long this endpoint's answer may be reused, in milliseconds. The `Cache` middleware — registered by
84
- * default — keeps the handler's result under the endpoint's key and its arguments and serves it until it
85
- * expires; declared nowhere, nothing is cached.
83
+ * How long this endpoint's answer may be reused, in milliseconds. The call keeps the handler's result under the
84
+ * endpoint's key and its arguments and serves it until it expires; declared nowhere, nothing is cached.
86
85
  *
87
86
  * **Only a `query` that takes no internal argument may carry one.** Internal arguments are how a call learns
88
87
  * who is asking (`.with(Self)`), so an endpoint that has them answers per caller, and one shared entry would be
89
- * one caller's answer handed to the next; such an endpoint is named in the log and left uncached. Guards still
90
- * run on every hit — a shared answer is not a public one.
88
+ * one caller's answer handed to the next; such an endpoint is named in the log and left uncached. The lookup
89
+ * runs after the guards, so a hit reaches only a caller they admitted — a shared answer is not a public one.
91
90
  */
92
91
  cache?: number;
93
92
  guards?: GuardCls[];
@@ -1,7 +1,7 @@
1
1
  export interface MenuRow {
2
2
  name: string;
3
3
  description?: string;
4
- /** The argument names a prompt takes, shown so a user knows what to type after the name. */
4
+ /** The argument names a row takes, shown so a user knows what to type after the name. */
5
5
  hint?: string;
6
6
  pick: () => void;
7
7
  }
@@ -14,7 +14,7 @@ export interface MenuProps {
14
14
  prefix?: string;
15
15
  onPick: (row: MenuRow) => void;
16
16
  }
17
- /** The composer's completion list: `/` commands and `prompt()` endpoints, or the `@` menu's reference rows. */
17
+ /** The composer's completion list: the chat's own `/` commands, or the `@` menu's reference rows. */
18
18
  export declare const DefaultAgentMenu: ({ className, rows, selected, prefix, onPick }: MenuProps) => import("react/jsx-runtime").JSX.Element | null;
19
19
  declare const _default: import("react").ComponentType<MenuProps>;
20
20
  export default _default;
@@ -23,7 +23,7 @@ export type ButtonProps<Result> = Omit<ButtonHTMLAttributes<HTMLButtonElement>,
23
23
  * button that is as wide as its longest state.
24
24
  */
25
25
  loadingMode?: "hold" | "replace";
26
- /** Whether a failed action renders its message under the button. Off leaves it to the framework toast. */
26
+ /** Whether a message passed to `onError` renders under the button. A thrown error is left to its thrower. */
27
27
  showError?: boolean;
28
28
  };
29
29
  /**
@@ -2,6 +2,7 @@ import type { ProtoLightFile } from "akanjs/constant";
2
2
  import type { ImgHTMLAttributes } from "react";
3
3
  type CsrImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> & {
4
4
  src?: string;
5
+ alt?: string;
5
6
  file?: ProtoLightFile | {
6
7
  url: string;
7
8
  imageSize: [number, number];
@@ -14,5 +15,5 @@ type CsrImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> &
14
15
  unoptimized?: boolean;
15
16
  fill?: boolean;
16
17
  };
17
- export declare const CsrImage: ({ src, file, className, abstractData, ...props }: CsrImageProps) => import("react/jsx-runtime").JSX.Element;
18
+ export declare const CsrImage: ({ src, alt, file, className, abstractData, ...props }: CsrImageProps) => import("react/jsx-runtime").JSX.Element;
18
19
  export {};
@@ -6,7 +6,7 @@ export declare const convToAntdColumn: (column: DataColumn<any>) => {
6
6
  key: string;
7
7
  dataIndex: string;
8
8
  title: string;
9
- responsive: readonly ["xs", "sm", "md", "xl"] | undefined;
9
+ responsive: readonly ["md", "lg", "xl"] | undefined;
10
10
  render: ((value: any, model: any) => ReactNode) | undefined;
11
11
  } | {
12
12
  key: string;
@@ -1,2 +1,2 @@
1
1
  import type { CsrLinkProps } from "./types.d.ts";
2
- export default function CsrLink({ className, children, href, replace, activeClassName, scrollToTop, activeExact, ...props }: CsrLinkProps): import("react/jsx-runtime").JSX.Element;
2
+ export default function CsrLink({ className, children, href, replace, activeClassName, scrollToTop, activeExact, noCache, ...props }: CsrLinkProps): import("react/jsx-runtime").JSX.Element;
@@ -29,6 +29,8 @@ export interface CsrLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
29
29
  activeExact?: boolean;
30
30
  /** Scroll to the top after client-side navigation. */
31
31
  scrollToTop?: boolean;
32
+ /** Bypass route cache for client-side navigation when supported by the renderer. */
33
+ noCache?: boolean;
32
34
  }
33
35
  export interface SsrLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof LinkProps | "href">, LinkProps {
34
36
  /** Destination route for server-rendered anchor output. */
@@ -5,7 +5,7 @@ export declare const CSR: {
5
5
  ({ children }: {
6
6
  children: ReactNode;
7
7
  }): import("react/jsx-runtime").JSX.Element;
8
- Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
8
+ Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
9
9
  Wrapper: ({ children, lang, head, manifest, fonts, appName, className, prefix, layoutStyle, }: CSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
10
10
  Inner: () => import("react/jsx-runtime").JSX.Element;
11
11
  Bridge: ({ lang, prefix }: CSRBridgeProps) => null;
@@ -13,7 +13,7 @@ export declare const CSR: {
13
13
  export type CSRProviderProps = ProviderProps & {
14
14
  fonts: ReactFont[];
15
15
  };
16
- declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
16
+ declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
17
17
  interface CSRWrapperProps {
18
18
  className?: string;
19
19
  appName: string;
@@ -8,7 +8,7 @@ declare global {
8
8
  export declare const Client: {
9
9
  (): import("react/jsx-runtime").JSX.Element;
10
10
  Wrapper: ({ children, theme, lang, path, dictionary, signals, reconnect, }: ClientWrapperProps) => import("react/jsx-runtime").JSX.Element;
11
- Bridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
11
+ Bridge: ({ env, lang, theme, prefix, wsConnect }: ClientBridgeProps) => null;
12
12
  Inner: () => import("react/jsx-runtime").JSX.Element;
13
13
  SsrBridge: ({ lang, prefix, initialPageState }: ClientSsrBridgeProps) => null;
14
14
  };
@@ -46,10 +46,9 @@ interface ClientBridgeProps {
46
46
  lang?: string;
47
47
  theme?: AkanTheme;
48
48
  prefix?: string;
49
- gaTrackingId?: string;
50
49
  wsConnect?: boolean;
51
50
  }
52
- export declare const ClientBridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
51
+ export declare const ClientBridge: ({ env, lang, theme, prefix, wsConnect }: ClientBridgeProps) => null;
53
52
  export declare const ClientInner: () => import("react/jsx-runtime").JSX.Element;
54
53
  interface ClientSsrBridgeProps {
55
54
  lang: string;
@@ -21,8 +21,6 @@ export interface ProviderProps {
21
21
  prefix?: string;
22
22
  /** App content rendered inside the system provider. */
23
23
  children: ReactNode | ReactNode[];
24
- /** Optional Google Analytics tracking id. */
25
- gaTrackingId?: string;
26
24
  /** Select mobile-style frame behavior or normal web layout. */
27
25
  layoutStyle?: "mobile" | "web";
28
26
  /** Enable reconnect helper. Defaults to local operation mode in CSR. */
@@ -3,13 +3,13 @@ import { type ReactNode } from "react";
3
3
  import { type ProviderProps } from "./Common.d.ts";
4
4
  export declare const SSR: {
5
5
  (): import("react/jsx-runtime").JSX.Element;
6
- Provider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
6
+ Provider: ({ className, appName, params, head, manifest, env, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
7
7
  Wrapper: ({ children, head, manifest, fonts, className, lang, path, prefix, layoutStyle, pageState, }: SSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
8
8
  };
9
9
  export type SSRProviderProps = ProviderProps & {
10
10
  fonts?: ReactFont[];
11
11
  };
12
- declare const SSRProvider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
12
+ declare const SSRProvider: ({ className, appName, params, head, manifest, env, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
13
13
  interface SSRWrapperProps {
14
14
  className?: string;
15
15
  appName: string;